home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 011a / pscrn43.zip / P-SCREEN.DOC < prev    next >
Text File  |  1991-11-11  |  220KB  |  4,465 lines
  1.  
  2.                 -----------------------------------------------
  3.                   -------------------------------------------                   
  4.                     ---------------------------------------                     
  5.                       -----------------------------------                       
  6.                         -------------------------------                         
  7.                           ---------------------------                           
  8.                             -----------------------                             
  9.                               -------------------
  10.                                 ---------------                                 
  11.  
  12.                  P-Screen and                   Rob W. Smetana
  13.                                        by       
  14.                  P-Screen                       and Pro~Formance
  15.                  Professional
  16.  
  17.                                 ---------------
  18.                               -------------------                               
  19.                             -----------------------                             
  20.                           ---------------------------
  21.                         -------------------------------                         
  22.                       -----------------------------------                       
  23.                     ---------------------------------------                     
  24.                   -------------------------------------------                   
  25.                 -----------------------------------------------                 
  26.  
  27.  
  28.  
  29.  
  30.                                 P-Screen  (tm)
  31.                             (Programmers' Editions)
  32.  
  33.                   **  Version 4.2  (11/91)   A Major Update  **
  34.  
  35.  
  36.  
  37.  
  38.  
  39.           Use Ram-Man to turn this into a Pop-Up quick reference guide.
  40.                  For details on Ram-Man, see the last few pages.
  41.  
  42.  
  43.           Or use our Multi-Print program to print it with 2-4 pages per
  44.           sheet of paper, on LaserJets, Toshiba -or- Epson printers, in
  45.           booklet form -or- left-to-right -or- portrait mode.
  46.  
  47.  
  48.  
  49.              Sophisticated screen management support for programmers.
  50.  
  51.          P-Screen and P~F Presents (another of our programs) are a very
  52.          powerful combination.  See the section on P~F Presents for details.
  53.  
  54.  
  55.  
  56.  
  57.           Copyright (C) 1988-1992, Rob W. Smetana.   All Rights Reserved.
  58.  
  59.                                                                            
  60.  
  61.          ============== Here's a brief overview of P-Screen. ==============
  62.  
  63.          * Design screens; save them, compressed, to Screen Libraries,
  64.            executable COM files, ASM files or to Ascii uncompressed files.
  65.  
  66.          * Display screens from your programs, f-a-s-t, easily, with lit-
  67.            tle code.  We include subprograms to handle the details for you.
  68.  
  69.          * It's fast and easy with:  mouse support, pull down menus and
  70.            fast keyboard hotkeys.
  71.  
  72.          * P-Screen "Pro" even writes your QuickBASIC programs for you!
  73.  
  74.          * Now supports QuickBASIC 3.0 - 4.x, BASIC Professional (PDS).
  75.  
  76.          * Add P~F Presents and you can create:  Desktop Presentations,
  77.            Program Demos, Program Prototypes, Tutorials, Marketing Aids,
  78.            Training/Development Programs, Management Presentations, etc.
  79.  
  80.  
  81.          ===================== WHAT'S NEW THIS VERSION =====================
  82.  
  83.          Bright Background, You can now create dazzling, bright-background
  84.          Changed Commands,  screens.  Alt-D now means Draw lines -or- boxes.
  85.          "ASM" screens      Alt-X now means Delete Line (this was Alt-D).
  86.                             You can now create ".Asm" screens that you
  87.                             link with programs, then CALL to display!
  88.  
  89.          Mouse Support,     A mouse speeds up screen creation by 100-200%.
  90.          Pull Down Menus,   Menus are fast and friendly.  Use them alone,
  91.          What you see..     or in combination with keyboard hot keys.
  92.                             You'll now see what boxes, lines, shading,
  93.                             painting, etc. look like as you go.
  94.  
  95.          PDS 7 Support      We added support for Microsoft's BASIC 7.
  96.  
  97.          Ruler.Exe          We replaced the "internal" ruler with a TSR.
  98.  
  99.          More Extensive     Press F1 (Help) then choose a topic you'd like
  100.          Help               help with, or browse through the Quick Reference
  101.                             guide -- which you can customize!
  102.  
  103.  
  104.          ======================== ABOUT THIS MANUAL ========================
  105.          This manual is used by all versions of P-Screen:  P-Screen Profes-
  106.          sional, P-Screen Plus, and user-supported versions.
  107.  
  108.          It's formatted with 60 lines per page (most pages).  To print it,
  109.          at the DOS prompt, type:  copy p-screen.doc prn <cr>.  To avoid
  110.          printing it, use our Ram-Man to view it while using P-Screen.
  111.  
  112.          NOTE:  We normally avoid "high Ascii" characters in our manuals
  113.                 -- since some printers can't handle them.  But we in-
  114.                 luded some here (see the sections on F10 Options and
  115.                 Big! Font).  If your printer can't print high Ascii
  116.                 characters, edit this manual with your word processor.
  117.                 Replace the "high Ascii" characters (with Xs or ?), then
  118.                 print it. OR, use our Multi-Print program to print this.
  119.                 It's FOUR internal fonts handle most every ASCII character.  
  120.  
  121.  
  122.          ============ FOR INFORMATION OR SUPPORT, CALL OR WRITE ============
  123.  
  124.  
  125.            Rob W. Smetana  132 Alpine Terrace   San Francisco, Ca.  94117
  126.  
  127.                  Phone:    (415) 863-0530  (10-5 Pacific time please)
  128.  
  129.  
  130.                  We welcome your feedback, suggestions and comments.
  131.  
  132.  
  133.  
  134.              Copyright (C) 1988-1992, Rob W. Smetana and Pro~Formance
  135.  
  136.          P-Screen, it's manual and supporting materials are protected by
  137.          U.S. and International Copyright Laws.   All Rights Reserved.
  138.          P~F Screen Design, P-Screen, P-Screen Professional, P~F Presents,
  139.                   PFP, Pro~Formance, and P~F are Trademarks of:
  140.                          Rob W. Smetana & Pro~Formance
  141.  
  142.  
  143.  
  144.  
  145.          ========================== DISCLAIMER ============================
  146.  
  147.          This product is provided "AS IS" without warranty of any kind.
  148.          The entire risk as to the results and performance of this product
  149.          is assumed by you.  We warrant only that any disks we sent you
  150.          are free from physical defects and workmanship under normal use
  151.          and service for a period of 90 days from the date shipped.
  152.  
  153.          Our entire liability, and your exclusive remedy, as to the disk
  154.          shall be to, at our option, either (1) return the purchase price;
  155.          or, (2) replace disks which don't meet our limited warranty.
  156.           * Since you can try "user supported" versions of our programs
  157.             before ordering them, we offer no other warranty beyond that
  158.             stated here.  We'll gladly replace defective disks.  But no
  159.             refunds or credits can be issued.
  160.  
  161.          Neither Pro~Formance nor RWS & Associates, nor any of their
  162.          officers or employees shall be held responsible for:  failures
  163.          of this program to satisfy any needs, damages due to using
  164.          P-Screen, or any effects this program has on you, your business
  165.          or operations.
  166.  
  167.          P-Screen, its manual and its support files may be modified/changed
  168.          from time to time.  They may contain operational inaccuracies or
  169.          typographical errors which may be corrected by future versions,
  170.          if any.  Registered users may be notified of available updates.
  171.  
  172.  
  173.                                                                            
  174.  
  175.          ======================= LIMITED LICENSE ========================
  176.  
  177.          P-Screen is NOT public domain or free software.  P-Screen is a
  178.          copyrighted work, which is distributed as "user-supported"
  179.          software (also known as "shareware").
  180.  
  181.          Unregistered users of this software are granted a limited
  182.          license to "try out" the user-supported version, on a private,
  183.          non-commercial basis, for the express purpose of determining
  184.          whether it suits your needs.  At the end of this trial period,
  185.          you must either register your copy or stop using it.
  186.  
  187.          * Running P-Screen 15-20 different times should allow you
  188.            to decide if it's going to be useful to you.  Therefore
  189.            the "trial period" is set at 20 P-Screen sessions.
  190.  
  191.          ===============================================================
  192.  
  193.          WARNING:  You MAY NOT USE this program in any organization or
  194.          in the conduct of any business activity without a prior pur-
  195.          chase or license arrangement.
  196.  
  197.          Screens created using this program MAY NOT be used or included
  198.          in any business, for-profit or for-money activity without a
  199.          prior purchase or license arrangement.  This includes all types
  200.          of screens, and all types of activities the purpose of which is
  201.          to derive compensation or income (whether realized or not,
  202.          including shareware programs).
  203.  
  204.          ===============================================================
  205.  
  206.          What does all this really mean?  It's really very simple.  Try
  207.          it.  Then either pay for it, or stop using it.
  208.           * If you use this program, then you should pay for your copy.
  209.             P-Screen is NOT free, and we're not giving away free copies.
  210.             We are giving you the chance to try it before you buy it.
  211.  
  212.           * Paying for this software allows us to stay in business and
  213.             provide you with support, enhancements and updates.  And : : :
  214.  
  215.  
  216.                                                              continued . . .
  217.  
  218.                                                                            
  219.  
  220.          +--WHEN YOU REGISTER : : :----------------------------------------+
  221.          |                                                                 |
  222.          |  We appreciate the support and honesty of those who register.   |
  223.          |  To "say thanks" in return, when you register you'll receive:   |
  224.          |                                                                 |
  225.          |  1. P-Screen\+ with new features we're adding right now:        |
  226.          |                                                                 |
  227.          |     - The option to create executable "Com" screens!            |
  228.          |                                                                 |
  229.          |     - Cut & Paste (Paste sections across screens), Repeat, Re-  |
  230.          |       Color, Center Block -- all supported by REGISTERED users. |
  231.          |                                                                 |
  232.          |     - Increased BIG! Font support (ALL characters, MANY fonts)  |
  233.          |                                                                 |
  234.          |  2. The ability to create Screen libraries with ten times the   |
  235.          |     capacity.  P-Screen\+ stores up to 100 screens per Library. |
  236.          |                                                                 |
  237.          |  3. Enhanced screen restore routines to display any size screen.|
  238.          |                                                                 |
  239.          |  4. Two extra programs to save you enormous amounts of time:    |
  240.          |                                                                 |
  241.          |     - PF-Cap: a TSR program to capture screens from any ap-     |
  242.          |       plication, then load, edit and store them in P-Screen.    |
  243.          |                                                                 |
  244.          |     - Manager: a program letting you create screen libraries    |
  245.          |       with screens from other libraries -- in any order.        |
  246.          |       Manager also makes it easy to add screens you captured    |
  247.          |       using PF-Cap to your screen libraries.  Finally, Manager  |
  248.          |       is also the only way to delete screens from screen        |
  249.          |       libraries.                                                |
  250.          |                                                                 |
  251.          |  5. Phone support                            and more . . .     |
  252.          |                                                                 |
  253.          +---------- Or, register for P-Screen Professional ---------------+
  254.          |                                                                 |
  255.          |  For even greater power, you can also register for P-Screen     |
  256.          |  Professional.  It'll write your data entry programs for you!   |
  257.          |  And it comes with several other subroutines to make your       |
  258.          |  life even easier, and save you time & money!                   |
  259.          +-----------------------------------------------------------------+ 
  260.                                                                            
  261.  
  262.  
  263.          ======================== To REGISTER : : =========================
  264.  
  265.          A registration form is at the end of this manual.
  266.  
  267.          To register, send your name, address, registration fee and your
  268.          comments and suggestions to:
  269.  
  270.          Pro~Formance     132 Alpine Terrace     San Francisco, Ca.  94117
  271.  
  272.                                                                             
  273.  
  274.          ============ DISTRIBUTORS OF "USER-SUPPORTED" SOFTWARE ===========
  275.  
  276.          Bulletin board Sysops, clubs and shareware distributors may
  277.          copy and distribute shareware versions of P-Screen, provided:
  278.  
  279.          *** Your company name IS NOT:   California Freeware         ***
  280.                                            American Freeware
  281.                                                  US Freeware
  282.              (or any other firm, group or association with "Freeware"
  283.              in its name, literature, promotions, etc.) which companies
  284.              are PROHIBITED from distributing ANY products by Rob W.
  285.              Smetana, Pro~Formance, RWS & Assoc. or their officers,
  286.              staff or associates.
  287.  
  288.          *** Your company or group DOES NOT include among its staff, ***
  289.              officers, associates, consultants, members, or directors
  290.              RONALD CHORDIGIAN, members of his family or his assigns.
  291.  
  292.          *** Your adds, literature and company name DO NOT include:  ***
  293.              "free software," "freeware," "free" or other such
  294.              terms which misrepresent "user-supported" software.
  295.  
  296.          (1) It is distributed in completely unmodified form.
  297.  
  298.          (2) You charge nothing other than a "disk distrubution fee"
  299.              of up to $8.00 to cover distribution and handling.
  300.  
  301.          (3) You state YOUR fee is NOT payment or registration for
  302.              OUR software.
  303.  
  304.          (4) You clearly encourage registration by stating that con-
  305.              inued use justifies sending contributions to the developer.
  306.  
  307.          (5) You include all files mentioned in ReadMe.BAT including:
  308.              P-Screen.(Exe/Doc/Psl), LoadScrn.Obj, *.Bas, rsLodBin.Obj,
  309.              rsCmpRst.Obj, PS_Demo.(Bas/Qlb) and ".PSS" files.
  310.  
  311.  
  312.  
  313.                                                                              
  314.  
  315.          ==================== P-SCREEN IN A NUTSHELL ======================
  316.  
  317.          P-Screen and P-Screen Professional are among the most sophis-
  318.          ticated screen management systems available.
  319.  
  320.           * Designing help, menu, data-entry screens, etc. is a snap.
  321.  
  322.           * Big! Font lets you easily add large-character messages.
  323.  
  324.           * Save screens in libraries or as Ascii, "Asm" or "Com" files.
  325.             Screen libraries compress screens saving disk space and RAM.
  326.             "Asm" and "Com" screens are also compressed.  And to display
  327.             "Asm" screens from your programs, just CALL them!
  328.  
  329.           * Load screens from screen libraries, or Ascii or BSAVE files.
  330.             Registered users even receive a TSR program letting you
  331.             "capture" and edit screens from other applications.
  332.  
  333.           * Display screens from your programs -- f-a-s-t, easily, with
  334.             little code, and with no "external screen loaders."  We in-
  335.             clude subprograms to "Link" with QuickBASIC 3.0 - PDS 7 programs.
  336.  
  337.           * P-Screen Professional even writes your data entry programs for
  338.             you, and includes separate subroutines to get user input, val-
  339.             idate it and format it for you, and handle field calculations.
  340.  
  341.           * Use P-Screen to create:
  342.             - Menus, help screens, data entry, program demos, prototypes, etc.
  343.             - Ascii files for any purpose (word proc., database, batch files).
  344.  
  345.  
  346.          Features:
  347.          .........
  348.  
  349.           * Easy screen design: boxes/lines/join/text/repeat/clipboard/Big!
  350.             Font/any Ascii character/paint/copy/move/erase/WalkAbout/Undo.
  351.  
  352.           * Supports 25, 43 or 50 line screen modes.
  353.  
  354.           * Save to or Load from screen Libraries or Ascii, COM or ASM files.
  355.             - Libraries store up to 100 "compressed" binary screens.
  356.               Compressing screens saves disk space and RAM.
  357.             - Libraries store full or partial screens (sub-screens).
  358.             - Change your screens without having to change your programs.
  359.             - Save full-screen Ascii or ".Com" files for any purpose.
  360.  
  361.           * Easily display screens from your programs.  F-a-s-t!
  362.             - "Indexed" libraries plus assembler routines = fast access
  363.               and display.  Display 20-100 screens a second on a 16 mz PC!
  364.             - External screen-loaders not needed (or welcome)
  365.  
  366.                                                          continued . . .
  367.                                                                            
  368.  
  369.          P-Screen:
  370.          .........
  371.  
  372.           * Makes screen design easy, logical and as painless as possible.
  373.  
  374.           * Eliminates lots of text from programs (help screens, menus, data
  375.             entry screens, etc.); keep programs small and fast-loading.
  376.  
  377.           * Eliminates the disadvantages of keeping screens on disk:
  378.             load and display screens f-a-s-t!
  379.  
  380.           * Organizes screens in libraries (not separate Ascii, or BSAVE
  381.             files), save disk space, ease distribution, eliminate errors.
  382.  
  383.           * Eliminates the need for external "screen-loaders."  It reduces
  384.             dependence on others:  you manage everything from your program.
  385.  
  386.  
  387.          An unabashed plea for help
  388.          ..........................
  389.  
  390.          Your screens (libraries or Ascii) could be used from any
  391.          program.  But the fast screen display routines we provide
  392.          currently support QuickBASIC programmers. (QB 3.0 or later).
  393.  
  394.           * To display your screens from Pascal, C, Assembler, dBASE or
  395.             other languages, 1-2 small routines would have to be converted.
  396.  
  397.           * These conversions shouldn't be difficult, but we don't have
  398.             the expertise.  If you can work with us on this, let us know.
  399.  
  400.  
  401.                                                                              
  402.  
  403.          ==== ABOUT SCREENS, SCREEN LIBRARIES and SCREEN COMPRESSION ====
  404.  
  405.          With P-Screen you can:
  406.           * LOAD screens (from disk) from Libraries, or Ascii or BSAVE files.
  407.  
  408.           * SAVE screens to Screen Libraries or to "Com," "Asm" or Ascii
  409.             files.  PF-Cap also lets you capture and save BSAVE files.
  410.             - "Com" files are compressed, "executable" files.  Run them as
  411.               you would any program.  They pop up instantly -- complete
  412.               with colors, lines, boxes, shading and text.  They're great
  413.               to start programs (while the main program loads), in batch
  414.               files, for menus, and to start P~F Presents presentations.
  415.             - Ascii files are saved just as you see them -- without color.
  416.               Use them in batch files, word processing, databases, etc.
  417.             - Display ASM screens by just CALLing them (eg., call myscreen).
  418.  
  419.  
  420.          Advantages of screen libraries over separate Ascii or BSAVE files.
  421.          ..................................................................
  422.  
  423.           * Libraries store up to 100 screens in compressed, binary format.
  424.             - Compression saves you 20-80% -- of disk space and RAM.  On
  425.               average, screens are 40-50% smaller after compression.
  426.             - Screens are never uncompressed -- they're displayed as-is.
  427.             - NOTE:  Newer versions of P-Screen CAN display uncompressed
  428.               screens from older versions.  But older versions of
  429.               P-Screen CANNOT display the new compressed screen images.
  430.             - Also note that ONLY P-Screen's display routines will work.
  431.  
  432.           * Libraries store full or partial (sub) screens.  Pop them up
  433.             right where they were when you saved them, or change locations.
  434.  
  435.           * Libraries keep screens together, avoiding separate screen files.
  436.  
  437.           * Libraries are "indexed" for fast retrieval and editing.
  438.             This lets you quickly and easily find any screen, then pop
  439.             it up right where you want it.
  440.             - The first 4000 bytes of a library stores the screen index.
  441.               DON'T edit libraries outside P-Screen; you may destroy them.
  442.  
  443.           * To display library screens from your programs, just CALL
  444.             2 of the routines we supply.  We find the right screen,
  445.             then load and display it.  No hassles. (You can change
  446.             where it's displayed if you like.)
  447.  
  448.           * Libraries store 1-8 letter screen names, PLUS descriptions.
  449.             Just press F9 for a "directory" of screens in a library.
  450.             Have you ever tried that with a multi-screen BSAVE file?
  451.  
  452.           * Have you ever tried to load one screen from a multi-screen
  453.             BSAVE file, edit it, and put it back right were it was?
  454.             It's easy with P-Screen -- it's all done for you.
  455.  
  456.           * P-Screen displays screens THE SAME WAY YOUR PROGRAMS will --
  457.             using the same routines.  Press F1 while in P-Screen to see
  458.             how full screens would be displayed; press Alt-F10 to see
  459.             how subscreens would.  Speed & performance should be similar.
  460.             The section "Performance Hints" shows ways to maximize speed.
  461.                                                                           
  462.  
  463.            ========================== CONTENTS =========================
  464.  
  465.            IMPORTANT:  Improvements we made may have significant impli-
  466.            cations for you.  Please read the next 3 pages carefully!
  467.  
  468.  
  469.                Compressed Screens:  Implications .........       a
  470.  
  471.                Announcing:  P-Screen Professional ........       b
  472.                             P~F Presents .................       d
  473.  
  474.                Conventions, Requirements, Installation ...       e
  475.  
  476.                Getting Started ...........................       f
  477.  
  478.                Loading/Saving Screens - Keyboard or Mouse.       h
  479.  
  480.  
  481.                QUICK REFERENCE GUIDE:  Menus & Hot Keys ..       1
  482.  
  483.                  Pull Down Menus .........................       2
  484.                  Summary of Menus ........................       4
  485.                  Summary of Keyboard Hot Keys ............       5
  486.                  Tips on Using a Mouse ...................       6
  487.  
  488.  
  489.                DESIGNING SCREENS .........................       7
  490.  
  491.                  Colors, Drawing Symbols, Other Options ..       8
  492.                  Boxes, Lines, Joining, Copying, Moving,
  493.                    Text, Centering Text ..................       9
  494.                  Centering Blocks, WalkAbout (drawing with
  495.                  any character), Low/High Ascii Characters      11
  496.                  Insert/Delete Characters/Lines, Re-Color       12
  497.                  Repeat, Cut & Paste .....................      13
  498.  
  499.  
  500.                P-SCREEN PROFESSIONAL (which writes programs for you)
  501.  
  502.                  Alt-F:  Formatting screen fields ........      14
  503.                  The Field Format Window .................      15
  504.                  Field Names, 13 Field Types .............      17
  505.                  Decimal Places, Format Strings ..........      18
  506.                  Editing Format Strings ..................      19
  507.                  Range (Validating input), Help Screens ..      22
  508.                  Formulas ................................      23
  509.                  Fine-Tuning programs PS Pro Writes ......      24
  510.  
  511.  
  512.                FUNCTION KEY OPTIONS:
  513.  
  514.                  Help, A Word About "Paths" ..............      26
  515.                  Saving Full or Sub/Partial Screens ......      27
  516.                  Loading or Printing .....................      28
  517.                  "MakeMono," Library Directories .........      29
  518.  
  519.                                                     continued. . .     
  520.  
  521.  
  522.            ==================== CONTENTS (continued) ====================
  523.  
  524.                FUNCTION KEY OPTIONS: (continued)
  525.  
  526.                  Big! Font ...............................      30
  527.                   Tips on Using Big! Font ................      31
  528.                   Creating Big! Fonts ....................      Appendix I
  529.  
  530.                                                                            
  531.                PF-CAP & MANAGER - two separate programs ..      36
  532.  
  533.  
  534.                DISPLAYING SCREENS FROM YOUR PROGRAMS:  QB 4.5 or PDS
  535.                (See Appendix II for QuickBASIC 3.0)
  536.  
  537.                  Adding our Routines to your Libraries ...      39
  538.                  Assembling and Displaying ASM Screens ...      40
  539.                  When to Manually Draw Screens ...........      42
  540.                  Displaying Library Screens ..............      43
  541.                    The Display.Screen FUNCTION ...........      44
  542.                    The Alternate Way .....................      45
  543.                  Restoring Screens to Different Locations.      48
  544.                  A Directory of Library Screens ..........      48
  545.  
  546.  
  547.                PERFORMANCE HINTS:  Displaying Screens ....      49
  548.  
  549.  
  550.                                  Appendices
  551.                                  ==========
  552.  
  553.                Creating Big! Fonts .......................       I
  554.  
  555.  
  556.                Displaying Screens with QuickBASIC 3 ......      II
  557.  
  558.  
  559.                Error Messages ............................     III
  560.  
  561.  
  562.                Other Programs by Pro~Formance ............      IV
  563.  
  564.  
  565.                REGISTERING/ORDERING ......................   Last Page(s)
  566.  
  567.  
  568.                                                                            
  569.          -a-
  570.                                                                            
  571.             SCREEN COMPRESSION:  Advantages and Implications for You!
  572.  
  573.          When you save screens to screen libraries, P-Screen compresses
  574.          them -- about 30-60%.  P-Screen also compresses screens you
  575.          save to "Com" or "Asm" files.
  576.  
  577.          To display these screens from your programs, use OUR screen-
  578.          restore sub-programs.  ONLY our subroutines can display
  579.          P-Screen's compressed screens.
  580.  
  581.           * If you use earlier versions of P-Screen, replace rsScrRst.Obj
  582.             with rsCmpRst.Obj included here (reg. users:  CompRest.Obj).
  583.  
  584.           * If you use other screen restore routines, they won't work.
  585.             Instead, use rsCmpRst.  It's a small, fast, assembler routine
  586.             which can display ANY text screen -- compressed or not.  You
  587.             can use it for ALL your screen-restore needs.
  588.  
  589.  
  590.          As you're developing screens, save them to a "scratch" library.
  591.          Then store the final version in the library you ultimately want
  592.          to use.  Why?  Compression might prevent you from ADDING things
  593.          to a screen you're working on.  Here's why.
  594.  
  595.           * One of P-Screen's most powerful features is its ability to
  596.             load screens from screen libraries, then let you edit them
  597.             and put them right back where they were.
  598.  
  599.           * But say you create a large, empty box and save it.  Because
  600.             it's empty, P-Screen compresses it a lot.
  601.  
  602.             If you then add lots of text or other boxes and save it
  603.             again, P-Screen can't compress it as much.  The amount of
  604.             library disk space now required may exceed the amount
  605.             P-Screen reserved when you first saved the screen.  When
  606.             this happens, P-Screen tells you "screen exists in smaller
  607.             form, save it using another screen name."
  608.  
  609.             To minimize the impact of this:
  610.  
  611.             - Save screens, when you first create them, to a "scratch"
  612.               library.  Later, save the final version to the library
  613.               you want.
  614.  
  615.             - Or, if you plan to add lots of stuff to a screen you're
  616.               creating, fill blank areas with random garbage, save it
  617.               then delete the garbage.  This might waste a little disk
  618.               space -- but not as much as would be wasted if you have to
  619.               save 2-3 versions of the same screen.
  620.                                                                           
  621.  
  622.          -b-
  623.  
  624.          =============== ANNOUNCING:  P-SCREEN PROFESSIONAL ==============
  625.  
  626.          We designed P-Screen Professional (PS Pro) to save you enormous
  627.          amounts of time.  PS Pro does this in several ways:  by writing
  628.          programs for you, by offering several subroutines you can use
  629.          as-is in any program you write, and by letting you "capture"
  630.          screens then easily load them into P-Screen.  To give you an
  631.          idea of the power of this, look at the two demo programs we
  632.          include with P-Screen:  ToOrder.Bas and Employee.Bas.  These
  633.          programs were written ENTIRELY by PS Pro -- in 2 seconds each!
  634.  
  635.          P-Screen Professional:
  636.  
  637.           * Writes your data entry programs for you!  Just tell PS Pro
  638.             where each field is and its "field type."  Then press a key.
  639.           * Supports 13 field types.  Choose a field type and P-Screen
  640.             formats printing and editing for you.  Field types include:
  641.             string, upper case, proper name, date, phone number, Zip Code,
  642.             Social Security number, numeric string, integer, long integer,
  643.             single precision, currency and double precision.
  644.           * Comes with several subroutines you can use in any program to:
  645.             - handle ALL user input (text, extended keys, printer codes)
  646.             - format text and numbers for easy editing or printing
  647.             - print with assembler speed
  648.             - convert all lower case text to "proper name" format
  649.           * Includes a separate TSR program letting you "capture"
  650.             screens from other applications then load them into P-Screen
  651.             for editing or storing in screen libraries.
  652.           * Includes "P-Screen Library Manager" -- a separate program
  653.             letting you create screen libraries from screens in other
  654.             libraries.  It's also the only way to delete screens from
  655.             screen libraries.
  656.  
  657.          Here's a summary of the subprograms we include with PS Pro.
  658.          These are included in PS_Demo.QLB and BC7Demo.Qlb (your Quick
  659.          Libraries).  Registered users receive separate files to add
  660.          to their own libraries or link directly to their programs.
  661.  
  662.          Name           Purpose
  663.          ============   ==================================================
  664.          rsMinput       Handle ANY type of user input:  A single key (like
  665.                         a menu choice), a full line (80 columns) of text,
  666.                         function keys, cursor pad keys, file names, anything!
  667.                         - "M" means Mask.  rsMinput will format data entry
  668.                           using a mask you supply.  For example, for Phone
  669.                           Numbers, use a mask like (...) ...-....  rsMinput
  670.                           accepts input where "." appears, and automatically
  671.                           skips over parentheses, spaces, hyphens, etc.
  672.                         - You specify the Length of each field (# of charac-
  673.                           ters) and which keys are Valid (eg., numbers only,
  674.                           A-D for 4 menu choices, upper case for file names).
  675.                         - You can ask rsMinput to exit on "extended keys,"
  676.                           and report which one was pressed.  This might
  677.                           include function keys, cursor pad keys, Alt-key
  678.                           combinations, etc.
  679.                         - P-Screen uses rsMinput to handle every key you press!
  680.  
  681.                                                           continued . . .    
  682.  
  683.          -c-  Announcing P-Screen Professional (continued)
  684.  
  685.          Name           Purpose
  686.          ============   ==================================================
  687.          OneKey         Gets one key from the user -- a menu choice, cur-
  688.                         sor pad or function keys, etc.  You specify which
  689.                         keys are "valid."
  690.  
  691.          Mask &         Used by rsMinput for "formatted input," you can
  692.          StripMask      also call Mask directly to print formatted text.
  693.  
  694.          FormatUsing    Converts a number into a string for editing or
  695.                         printing.  It includes ALL of BASIC's "Print Using"
  696.                         options to insert dollar signs, commas, decimal
  697.                         points, etc. -- at your option.
  698.  
  699.          ProperName     Type "john smith" or "san francisco" and ProperName
  700.                         returns it properly capitalized (ie., it returns
  701.                         "John Smith" and "San Francisco").  Speeds typing.
  702.  
  703.          rsQprint       Assembler routine to quickly print text on the screen.
  704.                         You just tell it where to print (row & column), which
  705.                         color to use, and which string to print.
  706.  
  707.          Exists         A QuickBASIC function to tell if files exist
  708.                         (before you try to open or write over them).
  709.                         Helps eliminate the need for "On Error."
  710.  
  711.          StripTail      Strips any character from the end (tail) of
  712.                         strings.  StripTrail is particularly useful
  713.                         for striping Null characters (Chr$(0)) from
  714.                         file records or fixed-length strings.
  715.  
  716.          We urge you to run and study the demo programs Employee.Bas and
  717.          ToOrder.Bas to see these subroutines in action.  Run each in
  718.          QuickBASIC 4.x / PDS 7 loading Quick Library PS_Demo / BC7Demo.
  719.  
  720.          Also see Routines.Doc for further details.
  721.  
  722.  
  723.                                                                              
  724.          -d-
  725.  
  726.          ================ ANNOUNCING:  P~F PRESENTS (PFP) ================
  727.  
  728.          P~F Presents is a desktop presentation system with 3 programs.
  729.  
  730.          With P-Screen you:
  731.          ..................
  732.           * Design screens (or "slides").
  733.           * Save screens tp libraries (or Ascii or "COM" files).
  734.  
  735.          With PFP you:
  736.          .............
  737.           * Create presentation agendas ("slide shows") which can include:
  738.             - Menus which "branch" to various parts of your presentation,
  739.               depending on the option your viewer selects.  For example:
  740.               -- Which product do you want information on?
  741.               -- Which topic (in a tutorial) do you want to review?
  742.             - Timed slides (PFP pauses, then automatically shows the next)
  743.             - Special effects:  sound, "wipes," exploding windows, gosubs
  744.           * Display your presentations, or let others do it by themselves.
  745.             And see the "use monochrome" option below.
  746.             - Or use PFShow, a smaller program, to display presentations.
  747.  
  748.          Possibilities:
  749.          ..............
  750.           * Program demos or prototypes      * Program tutorials
  751.           * Sales presentations              * Management/Staff briefings
  752.           * Training programs                * Highlight product information
  753.           * Customer information             * Tourist guides
  754.           * Restaurant guides                * Directories (Names, phone #s)
  755.                             And on and on and . . .
  756.          You can also:
  757.          .............
  758.           * Display full screens or sub-screens.  Sub-screens (a single
  759.             character, a line, a box, anything) are useful for many things
  760.             -- like animation or "building slides" on-screen a section at a
  761.             time.  "Here's point A." "Here's point B." "Here's point C." etc.
  762.  
  763.           * Create self-running presentations that cycle back to the
  764.             beginning when someone finishes (or asks to quit).
  765.             - Called "locked" presentations, these need a "key" to exit.
  766.  
  767.           * Load any Ascii file, then dress it up with color, boxes, etc.
  768.  
  769.          Other Features:
  770.          ...............
  771.           * P~F Presents uses "text mode" of your PC (not graphics).  That
  772.             means presentations may be viewed on any PC, on any monitor.
  773.  
  774.           * A "use monochrome" option lets you create 1 version of your
  775.             presentation, then let the viewer choose whether to view it in
  776.             color or monochrome (if they have a mono/composite monitor).
  777.             - This eliminates the "unreadable text" problem on some
  778.               monitors when text is displayed on colored backgrounds.
  779.             - It also eliminates the tedium of having to create 2 or more
  780.               versions of presentations:  one in color, one black & white.
  781.  
  782.           * P~F Presents includes all of P-Screen's features to create
  783.             dazzling screens in minutes.                                 
  784.  
  785.  
  786.          -e-
  787.  
  788.          =============== CONVENTIONS WE USE FOR CONVENIENCE ===============
  789.  
  790.          <cr>              Press Enter (Return)
  791.          Esc or <Esc>      Press the Escape key
  792.          Alt-key           HOLD DOWN the Alt key, then press another key
  793.          <R>               Options supported by and sent to REGISTERED users
  794.          Hot Key / Menu    To select options, you can press keyboard
  795.                            "hot keys" or choose from menus.  Whenever
  796.                            we discuss an option, we'll show you which
  797.                            hot key AND which menu you'd use.  For example,
  798.                            to draw a box:            Alt-D / Draw - Box
  799.                                                        ^          ^
  800.                              Press the Box "hot key" --|          |
  801.                              Or choose the "Box" option from      |
  802.                              the "Draw" menu ---------------------|
  803.  
  804.  
  805.  
  806.          ====================== SYSTEM REQUIREMENTS =======================
  807.  
  808.          Computer:  IBM PC, XT, AT, PS/2 or compatible      Memory:  256k
  809.               DOS:  2.1 or later (required)                Monitor:  Any
  810.              Disk:  Hard or RAM disks are fast, floppy disks are fine
  811.           Printer:  Any
  812.  
  813.          P-Screen writes directly to the screen.  It's fast, but can snow
  814.          older CGA monitors.  Set up DESQview or Windows accordingly.
  815.  
  816.  
  817.                                                                            
  818.          -f-
  819.  
  820.          ====================== INSTALLING P-SCREEN =======================
  821.  
  822.          Copy "Required" files to a "working disk" or hard disk directory.
  823.  
  824.  
  825.          REQUIRED (Design/Display Screens)  OPTIONAL (not needed to run)
  826.          ---------------------------------  -------------------------------
  827.  
  828.          P-Screen.Exe  P-Screen itself        ReadMe.Bat  Introduction
  829.          P-Screen.Psl  Help screen library  P-Screen.Doc  This manual
  830.                 *.Fnt  Big! Font font files        *.Bas  QuickBASIC demos
  831.             Ruler.Exe  TSR Ruler             PS_Demo.Qlb  QB 4+ Quick Library
  832.            PF-Cap.Com  \ Sent to regis-      BC7Demo.Qlb  PDS 7   "      "
  833.           Manager.Exe  / tered users        QB3-Demo.Exe  QB 3.0 User Library
  834.                                             Routines.Doc  Explains subroutines
  835.                                                           in PS_Demo/BC7Demo.
  836.          BrightBG.Obj  Toggle bright backgrounds on/off
  837.          LoadScrn.Obj  \   To display screens using
  838.          rsLodBin.Obj   )  QuickBASIC 4.0 or higher.
  839.          rsCmpRst.Obj  /   See "Displaying Screens from Your Programs"
  840.          CompRest.Obj      <--- registered users only
  841.  
  842.          LdScrn-7.Obj      To display screens using PDS 7
  843.                            Also use QB 4.5 routines listed above.
  844.  
  845.          QB3PScrn.Obj  \   To display screens from QuickBASIC 3.0 programs
  846.          QB3LdScr.Obj   )  See "Displaying Screens from Your Programs"
  847.          QB3RstPl.Obj  /   <--- registered users only
  848.  
  849.          ==================================================================
  850.  
  851.  
  852.          To design screens you need just 2 files: P-Screen.Exe &
  853.          P-Screen.Psl.
  854.  
  855.  
  856.          To use the Big! Font feature, you also need the font files
  857.          with the extension ".Fnt."  We currently have about 11 dif-
  858.          ferent Big! Fonts we send registered users.
  859.  
  860.  
  861.          To display screens from your programs, see "Displaying Screens."
  862.  
  863.  
  864.          To print your manual, at the DOS prompt type:
  865.  
  866.             COPY P-SCREEN.DOC PRN.
  867.  
  868.          Be sure to use a fixed spaced (not proportionally spaced) font.
  869.  
  870.                                                                              
  871.          -g-
  872.  
  873.          ========================= GETTING STARTED ========================
  874.  
  875.          Sample Programs
  876.          ...............
  877.          We urge you to begin by running the sample .BAS programs.  Two
  878.          of them demonstrate how to display screens from your programs --
  879.          PS_Demo (QuickBASIC 4.0+ or PDS 7) and QB3-Demo.  Two others
  880.          were written entirely by P-Screen Professional:  Employee.Bas
  881.          and ToOrder.Bas. In all cases, you need to load one of
  882.          P-Screen's User/Quick libraries:
  883.  
  884.           * PS_Demo, Employee and ToOrder require PS_Demo.Qlb or
  885.             BC7Demo.Qlb (for QB 4.x or PDS 7, respectively).
  886.           * QB3-Demo (for QuickBASIC 3.0) requires QB3-Demo.Exe
  887.  
  888.  
  889.          Running P-Screen
  890.          ................
  891.          At the DOS prompt, run P-Screen by typing:  P-Screen <cr>.
  892.  
  893.          P-Screen starts with an intro screen showing your major options.
  894.          "User-supported" versions also display some other information.
  895.          Press any key to clear the screen.
  896.  
  897.          We urge you to load and print two screens: QuikRef1 and EditHelp
  898.          They're 1-page summaries of screen design and text-editing commands.
  899.           * Press <F4> Load.  Then press <L>ibrary (load from a library file).
  900.           * When asked for the Library name, type "P-Screen <cr>" .
  901.           * P-Screen then displays the names of screens in P-Screen.Psl.
  902.             Use cursor keys to highlight QuikRef1 or EditHelp.  Press <cr>.
  903.           * When the screen loads, press <F5> Print.
  904.  
  905.          Screen Types
  906.          ............
  907.          P-Screen LOADS 3 types of screen files.  All must have the
  908.          appropriate extensions.
  909.  
  910.             Libraries   1-100 compressed screens stored in a library with
  911.                         a ".PSL" extension.
  912.                 Ascii   Any Ascii file with a ".PSS" extension.
  913.                 BSAVE   BSAVEd text files (NOT graphics) with a ".BSV"
  914.                         extension.
  915.  
  916.          P-Screen SAVES four types of screen files--with different
  917.          extensions.  (NOTE:  Registered users also receive a RAM-resident
  918.          program letting you "capture" ANY text screen and save it to
  919.          disk in BSAVE format.)
  920.  
  921.             Libraries   1-8 character names, plus ".PSL" (eg., P-Screen.Psl).
  922.                 Ascii   1-8 character names, plus ".PSS" (eg., MyScreen.Pss).
  923.                   Com   1-8 character names, plus ".COM" (eg., PS.Com)
  924.                   Asm   1-8 character names, plus ".ASM" (eg., PS.Asm)
  925.                                                                              
  926.          -h-
  927.  
  928.          ======== LOADING/SAVING SCREENS:  Keyboard or Mouse? =========
  929.  
  930.          When you ask to Load a screen, P-Screen asks whether you want
  931.          to load a screen from a Screen Library or whether you want to
  932.          load an Ascii or BSAVE screen from disk.  Press L, A or B.
  933.  
  934.          Once you've made your choice, P-Screen asks you to type in
  935.          the name of the screen (or file).  Instead of typing it in,
  936.          you can press <F2> to choose from a directory.
  937.  
  938.          When you ask for a directory, P-Screen displays all files in a
  939.          window that looks something like the following.  Note the top
  940.          line ("<- Page ->") and the references to a Mouse at the bottom.
  941.  
  942.          +---------------------------------------------------------------+
  943.          | ======================== <- Page -> ========================= |
  944.          + ------------------------------------------------------------- +
  945.          |                                                               |
  946.  
  947.          /                                                               /
  948.  
  949.          |                                                               |
  950.          +---------------------------------------------------------------+
  951.          | Cursor Keys/Mouse = Highlight it   <cr>/Double Click = Accept |
  952.          +---------------------------------------------------------------+
  953.  
  954.          To choose a file using:
  955.           * The KEYBOARD:  Press cursor keys to move the highlight
  956.             to the file you want.  Press <cr> to accept it.
  957.  
  958.           * A MOUSE:  Move the mouse cursor to the file you want.
  959.             Then "double click" the Left mouse button to accept it
  960.             (ie., press the Left button twice in quick succession.)
  961.  
  962.          If you asked to load a screen from a library, P-Screen then dis-
  963.          plays the names of all the screens in that library -- using the
  964.          same window.  Highlight the screen you want and press <cr>.
  965.  
  966.          NOTE:  If more files/screens exist than will fit in one window:
  967.  
  968.           * Using the KEYBOARD:  Press the Right cursor until the next
  969.             column of files/screens is displayed.  Press the Left cursor
  970.             to go back.
  971.           * Using a MOUSE: Move the mouse cursor to the "Page" line.
  972.             Click the Left mouse button on either the right or left side
  973.             of "Page" to display either the next or the last page.
  974.  
  975.  
  976.          The process of saving screens is about the same:
  977.          * Choose a type of screen (Library or Ascii, Asm or Com file).
  978.          * Type in a screen name -or- press <F2> to choose a name from
  979.            a directory of existing screen names.
  980.  
  981.          Please read "A Word About Paths" for further details.
  982.                                                                              
  983.          1
  984.  
  985.          ==================== QUICK REFERENCE GUIDE =======================
  986.  
  987.          This is a brief summary of P-Screen's options and commands.
  988.          For speed, convenience and flexibility, you may:
  989.  
  990.            Use the keyboard  -or-  a mouse in almost any combination.
  991.  
  992.            Use "pull down menus"  -or-  keyboard "hot key" commands.
  993.  
  994.  
  995.                                 Using a Mouse
  996.                     (Read "Mouse Tips" for further details)
  997.                     =======================================
  998.          
  999.          A mouse can cut the time needed to develop screens by 1/2 or
  1000.          more.  If you don't have a mouse -- and plan to develop more
  1001.          than 10-15 screens -- please consider getting one.  They're
  1002.          available for as little as $30 - $40 and the investment can
  1003.          save hours or days of time.
  1004.  
  1005.          Press the LEFT mouse button to:
  1006.  
  1007.           * Pull down the menus.
  1008.           * Choose options from menu (to "click on" an option).
  1009.           * Choose options in "dialogue boxes" (eg., click on
  1010.             "Y" to choose Yes, "N" for No, or "Esc" to cancel.)
  1011.           * Mark areas of the screen for drawing, copying, painting, etc.
  1012.  
  1013.          Press the RIGHT mouse button whenever you'd press the Esc key to:
  1014.  
  1015.           * Exit P-Screen, or exit the menus without making a choice.
  1016.           * Cancel an action you started (eg., to change your mind
  1017.             about drawing a box).
  1018.  
  1019.          P-Screen doesn't use the middle button on 3-button mice.
  1020.  
  1021.  
  1022.                      The F-a-s-t-e-s-t Way to Most Things
  1023.                      ====================================
  1024.  
  1025.          Use any combination of mouse/keyboard or menu/hot key options
  1026.          that "feels right."  We've found the fastest approach to many
  1027.          things is a combination of keyboard "hot keys" (using one hand)
  1028.          and a mouse (using the other hand).  For example, to draw a box:
  1029.  
  1030.           * With your mouse in one hand, move the cursor to the upper
  1031.             left corner of where you want a box to begin.
  1032.           * Press Alt-D with your other hand. ("D" for Draw).
  1033.           * Using the mouse, quickly move the cursor to the bottom right
  1034.             corner.  Press the LEFT mouse button to say "I'm done."
  1035.           * Your box is drawn -- taking about 2-4 seconds!
  1036.  
  1037.          Compared with using the keyboard only or a mouse only, this
  1038.          left/right hand combination of keyboard and mouse SPEEDS UP
  1039.          screen development by about 200 - 300 percent!                      
  1040.                                                                             
  1041.          2
  1042.  
  1043.          ======================= PULL DOWN MENUS ==========================
  1044.  
  1045.          Choose options using either pull down menus or keyboard "hotkey"
  1046.          commands.  For example, to draw a box you could press the Alt-D
  1047.          (Draw) hotkey, or pull down the "Draw" menu and select "Draw."
  1048.  
  1049.  
  1050.          To bring up the menus, press:
  1051.  
  1052.            The "/" key on your keyboard  -or-  the LEFT mouse button.
  1053.  
  1054.  
  1055.          P-Screen has 6 menus, each with several options.  When you press
  1056.          "/" or the Left mouse button, the following line appears at the
  1057.          top of your screen.
  1058.  
  1059.            File    Draw    Block    Edit    Options    Help  (F1)
  1060.  
  1061.  
  1062.          To move among the 5 main menus using:
  1063.  
  1064.           * The KEYBOARD:  press the Left/Right cursor keys.
  1065.           * A MOUSE:       move the cursor along the top line until
  1066.             it's on one of the 6 options.  Click the Left button to
  1067.             select it.
  1068.  
  1069.  
  1070.          NOTE:  You can press F1 almost anytime to get help (you needn't
  1071.          pull down the menus).  When you press F1, the Help menu will
  1072.          drop down.  Just highlight a "Help Topic" and press <cr>.
  1073.  
  1074.  
  1075.          Whenever you call up the menus, the last menu you used drops
  1076.          down.  If you haven't used the menus yet, the 1st menu ("File")
  1077.          will drop down.  It looks like this:
  1078.  
  1079.  
  1080.            File    Draw    Block    Edit    Options    Help  (F1)
  1081.  
  1082.          +--------------------------+
  1083.          | Save Screen           F2 |
  1084.          | Save Partial Screen   F3 |       NOTE:  On the right, next to
  1085.          |--------------------------|              each option in a menu,
  1086.          | Load Screen           F4 |              is the "keyboard hot key"
  1087.          |--------------------------|              you'd press to invoke
  1088.          | Print                 F5 |              that option.  For example,
  1089.          |--------------------------|              press Function Keys F2
  1090.          | New Screen / Clear    F6 |              or F3 to Save a screen,
  1091.          |--------------------------|              F4 to Load one, or Esc
  1092.          | Library Directory     F9 |              to exit P-Screen.
  1093.          |--------------------------|
  1094.          | Quit.  Exit to DOS.  Esc |
  1095.          +--------------------------+                                         
  1096.                                                                               
  1097.  
  1098.          3  Pull Down Menus (continued)
  1099.  
  1100.          To select options from menus using:
  1101.          ...................................
  1102.  
  1103.           * The KEYBOARD:
  1104.             - Highlight the option by pressing either Up/Down cursor keys
  1105.               or the 1st letter of the option you want.  If two or more
  1106.               options begin with the same first letter, keep pressing
  1107.               the 1st letter until the choice you want is highlighted.
  1108.             - Press <cr> to accept it.
  1109.  
  1110.           * A MOUSE:
  1111.             - Move the cursor to the option you want; press the Left button.
  1112.             - Or, hold down the Left button and drag the highlight to the
  1113.               option you want.  Release the Left button to accept it.
  1114.  
  1115.          Press Esc / Right button to exit the menus without making a choice.
  1116.  
  1117.  
  1118.          Here's are some notes on P-Screen's menus.  The next page has
  1119.          "snapshots" of each menu.  We'll explain all options later.
  1120.  
  1121.           * FILE
  1122.             - Save or Load full or partial screens.
  1123.             - Print a screen.
  1124.             - Prepare for a new screen:  clear it, choose 25/43/50 rows.
  1125.             - Get a "directory" of screens in a screen library,
  1126.               including the names and descriptions you gave them.
  1127.             - Quit.  Exit P-Screen, return to DOS.
  1128.  
  1129.           * DRAW
  1130.             - Draw boxes or lines.
  1131.             - Pop up the "Join" window letting you select:
  1132.               -- characters to join lines and boxes.
  1133.               -- low / high Ascii characters not found on your keyboard.
  1134.             - Select "WalkAbout" to "draw" with whatever character your
  1135.               cursor was on when you invoked this option.
  1136.  
  1137.           * BLOCK    ("Block" means a rectangular area of your screen)
  1138.             - Block commands let you move, copy, center, erase, paint
  1139.               or shade areas.
  1140.             - The Block menu also includes "Cut & Paste" -- a quick way
  1141.               to copy sections from one screen to another, or from one
  1142.               area of the screen to other areas (using a Clipboard).
  1143.  
  1144.           * EDIT  Enter regular or Big! Font text, Insert/Delete rows.
  1145.  
  1146.           * OPTIONS
  1147.             - "Colors/Lines/etc." lets you choose:
  1148.               -- foreground and background colors to draw, paint, etc.
  1149.               -- which of 6 line/box styles, or 3 shading styles to use
  1150.               -- how many rows on your screen (25, 43, 50)
  1151.               -- how sensitive your mouse is (very fast to very precise)
  1152.             - UNDO helps correct mistakes.
  1153.             - Re-Color lets you change everything in one color to another.
  1154.             - MakeMono duplicates P~F Present's "Show in Monochrome" option.
  1155.             - Demo shows how quickly partial screens can be displayed.      
  1156.          4
  1157.  
  1158.          Menus
  1159.          .....
  1160.  
  1161.          Here are snapshots of all 5 menus.  The next page lists the
  1162.          keyboard "hot keys" in a different form.  For a handy "Quick
  1163.          Reference Guide," print this page on one side of a sheet of
  1164.          paper, then print the next page on the other side.
  1165.  
  1166.            FILE                                 DRAW
  1167.          +--------------------------+         +----------------------+
  1168.          | Save Screen           F2 |         | Boxes/Lines    Alt-D |
  1169.          | Save Partial Screen   F3 |         |----------------------|
  1170.          |--------------------------|         | Join            "  J |
  1171.          | Load Screen           F4 |         |----------------------|
  1172.          |--------------------------|         | WalkAbout       "  W |
  1173.          | Print                 F5 |         +----------------------+
  1174.          |--------------------------|
  1175.          | New Screen / Clear    F6 |
  1176.          |--------------------------|
  1177.          | Library Directory     F9 |
  1178.          |--------------------------|
  1179.          | Quit.  Exit to DOS.  Esc |
  1180.          +--------------------------+
  1181.  
  1182.  
  1183.            BLOCK                                EDIT
  1184.          +--------------------------+         +----------------------+
  1185.          | Format (PS Pro)    Alt-F |         | Text           Alt-T |
  1186.          |--------------------------|         |----------------------|
  1187.          | Copy                "  C |         | Big! Font         F7 |
  1188.          | Move                "  M |         |----------------------|
  1189.          |--------------------------|         | Insert Row      "  I |
  1190.          | Paint               "  P |         | Delete Row      "  X |
  1191.          | Shade               "  S |         +----------------------+
  1192.          |--------------------------|
  1193.          | Center              "  A |
  1194.          |--------------------------|
  1195.          | Erase               "  E |
  1196.          |--------------------------|
  1197.          | Cut to Clipboard    "  K |
  1198.          | Paste from Clip.    "  L |
  1199.          +--------------------------+
  1200.  
  1201.  
  1202.            OPTIONS                              HELP
  1203.          +--------------------------+         +----------------------+
  1204.          | Colors/Lines/etc.    F10 |         | Summary of Commands  |
  1205.          |--------------------------|         |----------------------|
  1206.          | Undo               Alt-U |         | Text Editing Commands|
  1207.          |--------------------------|         |----------------------|
  1208.          | Repeat              "  R |         | Using a Mouse        |
  1209.          |--------------------------|         |----------------------|
  1210.          | Re-Color            "  N |         | PS Pro Writes Program|
  1211.          |--------------------------|         +----------------------+
  1212.          | MakeMono              F8 |
  1213.          |--------------------------|
  1214.          | Demo              Alt-F10|
  1215.          +--------------------------+                                     
  1216.  
  1217.          5
  1218.  
  1219.          Here's a summary of P-Screen's keyboard "hot keys."   For a
  1220.          1-page quick reference guide, print either this page or the
  1221.          screen "Quickref" in P-Screen.Psl.
  1222.  
  1223.          ====================== FUNCTION KEY Options ======================
  1224.  
  1225.          Function keys are used mainly for:  Getting Help, Saving,
  1226.          Loading, Printing and Clearing screens, and Choosing Options.
  1227.          Here's a summary; we'll describe each option later.
  1228.  
  1229.             F1 Help
  1230.  
  1231.             F2 Save a Full Screen (or a full or partial ASM screen)
  1232.             F3 Save Sub-screens (partial screens)
  1233.  
  1234.             F4 Load a screen
  1235.  
  1236.             F5 Print the current screen
  1237.  
  1238.             F6 New/Clear.  Start a new screen, choose 25/43/50 rows.
  1239.  
  1240.             F7 Big! Font.  Add Big! Font messages, load or alter a font.
  1241.  
  1242.             F8 View in monochrome.  Press a key after you hear the beep.
  1243.  
  1244.             F9 Review.  Get a directory of screens in a screen library.
  1245.  
  1246.             F10 Options.  Here you select:  Colors, Line/Box drawing styles,
  1247.                 Shading styles, # Rows/Lines on the Screen, etc.
  1248.  
  1249.          TO EXIT P-SCREEN:  Press Esc or Alt-<Q>uit (or use the File menu).
  1250.  
  1251.          TO UnDo MISTAKES:  Press Alt-U (or use the Options Menu).  UnDo
  1252.                             works for all major things (Move, Erase, Copy,
  1253.                             Paint, Text, etc.), and some minor things.
  1254.  
  1255.  
  1256.         ========================= ALT-key Options ========================
  1257.                 (hold down the Alt key; press the key listed below)
  1258.  
  1259.          Use Alt-key options to design screens.  Most options are intuitive.
  1260.          For example, press Alt-D to Draw Lines or Boxes, Alt-M to Move
  1261.          something, Alt-P to Paint, etc.   Here's a summary of your options.
  1262.  
  1263.                                  Add Hi/Low Ascii
  1264.                                  Characters, -or-
  1265.                       Draw Boxes    Join Lines      Text               Walk-
  1266.          UnDo Quit     or Lines      & Boxes    Enter/Center Cut/Paste About
  1267.          .....................................................................
  1268.            U    Q         D              J        T  /  C      K / L     W
  1269.  
  1270.  
  1271.          ---------- Block options ---------  Delete /                  Format
  1272.          Copy Move Erase Paint Shade Center Insert Row Repeat ReColor (PS Pro)
  1273.          .....................................................................
  1274.            C    M    E     P     S      A     D / X      R       N       F
  1275.                                                                                
  1276.          6
  1277.  
  1278.         ========================== MOUSE  TIPS ===========================
  1279.  
  1280.          To use a mouse you must first install a "mouse driver."  
  1281.           * Do this by including a line in your "config.sys" file, or run-
  1282.             ning a mouse program.  Consult your mouse manual for details.
  1283.  
  1284.           * P-Screen should work with mice compatible with Microsoft mice.
  1285.             It's also compatible with other mice:  for example, the inex-
  1286.             pensive Genius mouse run in "Mouse System" (or Microsoft) mode.
  1287.  
  1288.           * If P-Screen can't seem to access your mouse (and it IS connec-
  1289.             ted), either your mouse driver isn't installed, or P-Screen
  1290.             and your mouse/driver are incompatible.
  1291.  
  1292.          NOTE:  If you try P-Screen with a mouse, please, when you regis-
  1293.          ter, let us know whether P-Screen DID -or- DID NOT work with your
  1294.          mouse.  Tell us:  the manufacturer, the model #, if it's a serial
  1295.          or bus mouse, and the date and version # of your mouse software.
  1296.  
  1297.          Mouse Sensitivity
  1298.          .................
  1299.          If the mouse cursor moves around too quickly (or slowly), you
  1300.          can change the sensitivity of your mouse.  To do so:
  1301.  
  1302.           * Select Options (press F10 or select Options/Colors, etc.)
  1303.           * Press <M>ouse Sensitivity, then press Left/Right cursor keys.
  1304.           * Each time you press the Left/Right cursor, the "mouse
  1305.             sensitivity" changes by 5.  The range is 5 to 100.
  1306.             - Lower numbers  = LESS/SLOWER mouse cursor movement.
  1307.             - Higher numbers = MORE/FASTER mouse cursor movement.
  1308.  
  1309.          WalkAbout
  1310.          .........
  1311.          WalkAbout is a convenient way to draw or erase with any character
  1312.          on your screen.  It's also a handy way to "mend" broken lines.
  1313.  
  1314.           * When in WalkAbout mode, fast-moving mice can "spray" charac-
  1315.             ters around your screen.  This may or may not be what you want.
  1316.           * When mending broken lines, cursor keys may be more accurate.
  1317.  
  1318.                                                                         
  1319.  
  1320.          7
  1321.  
  1322.          ======================= DESIGNING SCREENS =======================
  1323.  
  1324.  
  1325.          Designing slides with P-Screen is very easy.  Most commands are
  1326.          intuitive and easy to remember.  Design screens using Alt-key
  1327.          options; use Function Keys to load or save screens, select
  1328.          options or get help (or use the menus instead of either).
  1329.  
  1330.  
  1331.                                   The Basics
  1332.                                   ==========
  1333.  
  1334.          P-Screen displays your full screen at all times. There's no com-
  1335.          mand or option line taking up real estate (Press F1 for Help).
  1336.  
  1337.           * Some find P-Screen's blank screen intimidating.  But, start
  1338.             designing and you'll enjoy having access to the full screen.
  1339.             - Remember, if you need HELP, press F1, or press "/" to
  1340.               bring down the menus (then press Left/Right cursor keys
  1341.               until the "Help" menus are visible).
  1342.  
  1343.           * When you begin most Alt-key options, P-Screen marks where
  1344.             you started with a highlighted, flashing symbol:  "M" = Move,
  1345.             "E" = Erase, "P" = Paint, etc.
  1346.  
  1347.           * Run and use Ruler.Exe if you need to know where you are.
  1348.             Press Ruler's hotkey (Ctrl-Esc), note the row/column you're
  1349.             on (and the colors or character on the screen), then press Esc.
  1350.  
  1351.  
  1352.          Change the number of rows on your screen (25, 43, 50) by pres-
  1353.          sing F6 New or F10 Options.  Be careful:  F6 clears your screen!
  1354.          Press F10 then <R>ows to redraw the screen with a different # of
  1355.          rows. (NOTE: Presentations should include ONLY 25-line screens.)
  1356.  
  1357.  
  1358.          Use cursor pad keys or a mouse to move around the screen.
  1359.  
  1360.  
  1361.          NOTE:  Insert and Delete keys work a little differently.  They
  1362.          Insert a space or Delete the character at the cursor, shifting
  1363.          everything to the right (insert), or the left (delete).  Be
  1364.          careful with Insert.  You can loose characters in column 80.
  1365.  
  1366.  
  1367.  
  1368.          All Options                     (F10 / Options - Colors, Etc.)
  1369.          ...........
  1370.          When you add text, draw boxes or lines, or shade or paint areas,
  1371.          P-Screen uses the "active" symbol sets and colors.  To change
  1372.          these, press F10 Options.  P-Screen displays a window like the
  1373.          one on the next page.
  1374.  
  1375.                                                                                  
  1376.                                                       continued . . .      
  1377.  
  1378.          8  Options (continued)
  1379.  
  1380.  
  1381.          +----------------------------|Options|------- <cr> or Esc = All Done +
  1382.          |                                                                    |
  1383.          | Color: Sample Text: ABCabc123@#$  +----Bright Background is OFF----|
  1384.          |    Up|Dn = Foreground ( 7 )       |  0  16  32  48  64  80  96 112 |
  1385.          |  Left|Right = Background ( 0 )    |  1  17  33  49  65  81  97 113 |
  1386.          |                                   |  2  18  34  50  66  82  98 114 |
  1387.          | 0 Black 1 Blue 2 Green  3 Cyan    |  3  19  35  51  67  83  99 115 |
  1388.          | 4 Red   5 Magenta 6 Yellow 7 White|  4  20  36  52  68  84 100 116 |
  1389.          |                                   |  5  21  37  53  69  85 101 117 |
  1390.          | <F1>=Toggle Bright/Normal         |  6  22  38  54  70  86 102 118 |
  1391.          | <F2>=Toggle Blinking On/Off       |  7< 23  39  55  71  87 103 119 |
  1392.          | <F3>=Toggle Bright Background     |  8  24  40  56  72  88 104 120 |
  1393.          |                                   |  9  25  41  57  73  89 105 121 |
  1394.          | <F9>=Line/Box Character Now: (┌)  | 10  26  42  58  74  90 106 122 |
  1395.          |                Options: (┌╔╒╓█▐)  | 11  27  43  59  75  91 107 123 |
  1396.          |                                   | 12  28  44  60  76  92 108 124 |
  1397.          |<F10>=Shading Character  Now: (░)  | 13  29  45  61  77  93 109 125 |
  1398.          |                Options:    (░▒▓)  | 14  30  46  62  78  94 110 126 |
  1399.          |                                   | 15  31  47  63  79  95 111 127 |
  1400.          |  <R>=# of screen rows (25/43/50)  +--------------------------------|
  1401.          |                                                                    |
  1402.          |  <M>=Mouse Sensitivity  (100)     Click left button on <> or Color |
  1403.          |                                                                    |
  1404.          +------ Press:  Cursor keys, R, M, or F1, F2, F9 or F10  -->   ------+
  1405.  
  1406.          NOTE: Press any key in brackets (e.g. <R>), or click the mouse on it.
  1407.  
  1408.  
  1409.  
  1410.          COLORS:  P-Screen starts with colors set to White (7) on
  1411.                   Black (0).  A blinking arrow in the "color window"
  1412.                   ("<" above) shows the active color.  "Sample Text"
  1413.                   shows how it'll look.  Click the mouse on any color, -or-
  1414.  
  1415.           * Press:  Up / Down cursor keys to change FOREGROUND colors.
  1416.                     Left / Right cursor keys to change BACKGROUND colors.
  1417.  
  1418.           * Press:  F1 to toggle Bright foreground On/Off.
  1419.                     F2 to toggle Blinking On/Off.
  1420.                     F3 to toggle Bright Backgrounds On and Off.  The
  1421.                     next page has important details on bright backgrounds.
  1422.  
  1423.             Once you select colors, everything you draw, or any text you
  1424.             add, appears in these colors -- until you change colors again.
  1425.  
  1426.  
  1427.          BOXES & LINES:  Press F9 to toggle among 6 different line
  1428.          styles.  You'll see the expression "Now: (┌)" change to
  1429.          reflect the "current" line draw set.
  1430.  
  1431.  
  1432.          SHADING:  Press F10 to toggle among 3 shading symbols (Ascii
  1433.          characters 176-178).  The expression "Now: (░)" will change.
  1434.  
  1435.                                                             continued . . . 
  1436.  
  1437.          9  Options (continued)
  1438.  
  1439.          SCREEN ROWS:  Press <R>OWS to switch to 25, 43, or 50 line screens.
  1440.          If your monitor dislikes your choice, an error message appears.
  1441.  
  1442.           * Switching to MORE rows WON'T destroy your screen.  P-Screen
  1443.             changes modes, then redraws your screen, giving you more
  1444.             rows to work with.
  1445.  
  1446.           * Switching to FEWER rows might blow away the bottom of your
  1447.             screen.  Caution.  Alt-U (undo) CAN'T undo this.  For example,
  1448.             switching from 50 to 25 rows would leave you with just the top
  1449.             25 rows of your 50-row screen.
  1450.  
  1451.  
  1452.          MOUSE SENSITIVITY:  Press <M>ouse to change how quickly (and far)
  1453.          the mouse cursor moves around when you move your mouse.  Then
  1454.          press the Left or Right cursor keys to change the sensitivity.
  1455.  
  1456.           * Each time you press Left or Right cursor, the "mouse
  1457.             sensitivity" changes by 5.  The range is 5 to 100.
  1458.  
  1459.             - Lower numbers  =  LESS/SLOWER mouse cursor movement.
  1460.             - Higher numbers =  MORE/FASTER mouse cursor movement.
  1461.  
  1462.  
  1463.          BRIGHT BACKGROUNDS:  Once you press F10 (Options), you can then
  1464.          press F3 to toggle "bright backgrounds" on or off.
  1465.  
  1466.          Bright backgrounds can help you create stunning, dazzling screens
  1467.          with colors often not seen on PCs.  But please understand that:
  1468.  
  1469.           * Bright backgrounds are actually achieved by using BLINKING
  1470.             FOREGROUND colors, and then telling the PC to display
  1471.             blinking as bright backgrounds.  This means that:
  1472.  
  1473.             - You CANNOT mix blinking foregrounds and bright backgrounds
  1474.               on the same screen -- they're mutually exclusive.
  1475.  
  1476.             - You CAN, however, mix bright and normal backgrounds.
  1477.  
  1478.           * If you display a screen with bright backgrounds on Hercules
  1479.             or monochrome monitors, you'll get BLINKING INSTEAD.  Bright
  1480.             backgrounds can ONLY be displayed on color-capable monitors.
  1481.  
  1482.          Finally, to display bright-background screens from your programs,
  1483.          you must "enable" your PC to do so.  We include an assembler
  1484.          module, BrightBg.Obj, to help you do this.  Please see "Display-
  1485.          ing Screens From Your Programs" for details.
  1486.  
  1487.           * If you use bright backgrounds on the main screen, any sub-
  1488.             screens you display on top of it must be created with bright ON.
  1489.  
  1490.           * Sub-screens CAN have normal backgrounds, but bright MUST be on.
  1491.                                                                           
  1492.          10
  1493.  
  1494.          ============== DESIGNING SCREENS:  ALT-key OPTIONS ==============
  1495.  
  1496.          Most options work the same way.  We'll discuss a few in detail,
  1497.          then highlight a few others.  In all cases, Esc = Cancel.  In
  1498.          most cases, when you press Alt-key, P-Screen "marks" your start-
  1499.          ing spot with a highlighted, flashing symbol:  "E" (erase), "M"
  1500.          (move), "P" (paint) or the "active" line/box or shade character.
  1501.  
  1502.          Drawing Boxes & Lines            Alt-D / Draw - Box/Lines
  1503.          .....................
  1504.          Move the cursor to where a box or line should begin.  Press Alt-D
  1505.          (we'll "mark" the spot with a blinking box corner).  Now move the
  1506.          cursor.  WHAT we draw depends on WHERE you move.  If you:
  1507.           * Move left or right on the same row, we'll draw a horizontal line.
  1508.           * Move up or down in the same column, we'll draw a vertical line.
  1509.           * Change both rows and columns, we'll draw a box.
  1510.  
  1511.          Press <cr> and you're done!  Your line or box is drawn in the
  1512.          style and colors you chose by pressing F10 (Options).
  1513.  
  1514.  
  1515.          Joining Boxes & Lines            Alt-J / Draw - Join
  1516.          .....................
  1517.          To "Join" a line to a box you drew, move the cursor to a line/
  1518.          box intersection.  Press Alt-J.  A window pops up showing the
  1519.          drawing symbols.  It also has many other Ascii characters (see
  1520.          "Ascii Characters" for details).  Move to the character you want
  1521.          and press <cr>.  Go to the other intersection and do it again.
  1522.  
  1523.  
  1524.          Erasing or Painting a Block      Alt-E, Alt-P / Block - Erase/Paint
  1525.          ...........................
  1526.          It's just like drawing a box.  Move to the one corner.  Press
  1527.          Alt-E (or Alt-P Paint).  A blinking "E" (or "P") marks the
  1528.          spot.  Move to the opposite corner.  Press <cr>.
  1529.  
  1530.  
  1531.          Copying or Moving a Block        Alt-C, Alt-M / Block - Copy/Move
  1532.          .........................
  1533.          Just like examples above -- with one more step.  Move to one
  1534.          corner.  Press Alt-C (or Alt-M Move).  A blinking "C" (or "M")
  1535.          marks the spot.  Move to the opposite corner.  Press <cr>.
  1536.  
  1537.          You've now marked what you want to copy or move.  Now move to
  1538.          where you want the block to appear.  Press <cr>.
  1539.  
  1540.  
  1541.          Adding / Centering Text          Alt-T, Alt-C / Edit - Text
  1542.          .......................
  1543.          You can enter text in 2 ways:  press Alt-T, or start typing.
  1544.  
  1545.          Move to the spot where you want to begin.  Press Alt-T or just
  1546.          start typing.  P-Screen "respects" your lines and boxes.  You
  1547.          can enter text up to the 1st line/shade character it finds (or,
  1548.          if none, the right side of the screen).  P-Screen scoops up any
  1549.          text it finds, highlights it, then lets you edit it.  Press:
  1550.          Alt-C to center text, <cr> when you're done, Esc to cancel.
  1551.                                                                              
  1552.          11
  1553.  
  1554.          Those are the basics.  Remember, press <cr> to complete an action,
  1555.          Esc to cancel it, and Alt-U (Undo) if you don't like the result.
  1556.  
  1557.          You can "draw" or "mark" things to copy/move/center/etc. by
  1558.          in almost any direction.  But "Pasting" from the "Clipboard"
  1559.          and Big! Font always "overwrite" moving right and down.
  1560.          Here's a summary of other P-Screen features.
  1561.  
  1562.          Auto-Joining
  1563.          ............
  1564.          When you draw horizontal or vertical lines, P-Screen "joins" the
  1565.          line to every line draw character in its path.  It does this by
  1566.          trying to guess what you're trying to accomplish.  Most of the
  1567.          time P-Screen's correct, and this speeds things up tremendously!
  1568.            * This only works when symbol sets are the same.
  1569.            * If our "guess" is wrong, use Alt-J to fix specific spots.
  1570.              - Press Alt-J and P-Screen displays a window showing most
  1571.                low/high Ascii characters.  Use cursor keys to move to
  1572.                the character you want.  Press <cr> to accept it.
  1573.  
  1574.  
  1575.          Centering a block  <R>           Alt-A / Block - Center
  1576.          .................
  1577.          Press Alt-A to center a block on your screen (a box, lines,
  1578.          Big! Font text, normal text, etc.).  (We already used Alt-C for
  1579.          Copy.  So "Alt-A" was arbitrary.)
  1580.           * Press Alt-A and P-Screen displays a blinking left/right arrow.
  1581.           * Move to the opposite corner.  Press <cr>.
  1582.  
  1583.  
  1584.          WalkAbout                        Alt-W / Draw - WalkAbout
  1585.          .........
  1586.          Alt-W (WalkAbout) copies the character your cursor's on --
  1587.          letting you draw (or erase) with ANY character on the screen.
  1588.          WalkAbout is handy to "patch" broken lines.  And if you don't
  1589.          see a character you like, press Alt-J.  A window pops up with
  1590.          most low/high Ascii characters.  (See the next section.)
  1591.           * Move to a character you want to walk around with.  Press
  1592.             Alt-W.  Nothing seems to happen -- Alt-W is "screen silent."
  1593.             Most Alt-key options show where you are on the screen.  Not
  1594.             Alt-W.  But, press cursor pad keys, and P-Screen starts
  1595.             copying the character (with its color) around the screen.
  1596.           * Move around using your cursor keys (or Home/End/PgUp/PgDn).
  1597.             Press Esc or <cr> to stop, you'll return to where you started.
  1598.           * Use WalkAbout to erase as you go -- just start on a blank spot.
  1599.  
  1600.  
  1601.          Ascii Characters:  Arrows, "Bullets," Other Characters    Alt-J
  1602.          ......................................................
  1603.          To enter any keyboard character, just press the key.  But your
  1604.          PC can display many other characters not on your keyboard.
  1605.          Called Low or High Ascii characters, these include the line draw
  1606.          characters used for boxes and lines.  They also include many
  1607.          other symbols including:  arrows, dots and small boxes useful
  1608.          for "text bullets" (sub-points), foreign language letters, etc.
  1609.          * To use these, press Alt-J, move to a character, press <cr>.
  1610.          * Now, if you want, use Alt-W (WalkAbout) to "draw" with it.
  1611.                                                                              
  1612.          12
  1613.  
  1614.          Inserting / Deleting CHARACTERS         Insert or Del keys
  1615.          ...............................
  1616.            * To insert or delete CHARACTERS, press Insert or Delete keys.
  1617.              - Insert adds a space at the cursor, pushing everything right.
  1618.              - Delete deletes what's at the cursor, shifting everything left.
  1619.  
  1620.  
  1621.          Inserting / Deleting LINES     Alt-I, Alt-X / Edit - Insert/Delete
  1622.          ..........................
  1623.            * To insert or delete LINES, press Alt-I or Alt-X.
  1624.              - Alt-I inserts a blank line at the cursor.  All lines at the
  1625.                cursor and below move down.  Anything on the last line is LOST.
  1626.              - Alt-X deletes the line your cursor's on, everything moves up.
  1627.  
  1628.  
  1629.          Re-Color (or New color) <R>      Alt-N / Options - Re-Color
  1630.          .......................
  1631.          Re-Color lets you change everything on your screen that's in one
  1632.          color to any other color.  It leaves all other colors alone.
  1633.          Re-Color is a very fast way to test different color combinations.
  1634.  
  1635.          For example, suppose you drew a box and several lines in Yellow
  1636.          on Blue.  You change your mind and now want them in White on Red.
  1637.            * You could press F10 Options, choose White on Red, and then
  1638.              use Alt-P Paint to paint each line.
  1639.            * But a much faster way is to press Alt-N.  Choose Yellow on
  1640.              Blue as the color you want changed.  Then choose White on Red
  1641.              as the color to change it to.
  1642.              - When you press <cr> your colors change instantly.
  1643.              - Everything on your screen that was Yellow on Blue is now
  1644.                White on Red.  This includes boxes, lines and anything else.
  1645.  
  1646.          Press Alt-N and P-Screen displays the top half of the Options
  1647.          window -- the part containing the color window.
  1648.            * It then asks you to choose the color you want changed.
  1649.              - Use cursor keys to choose a color (ie., move the blinking
  1650.                arrow to a color).  Press <cr>.
  1651.              - BE SURE to choose the proper Intensity/Brightness at-
  1652.                tribute.  For example, Bright White is a different color
  1653.                than Normal White.  Press F1 to toggle Bright on/off.
  1654.            * P-Screen then asks you to choose a new color.
  1655.              - Use cursor keys to choose a new color; press <cr>.
  1656.  
  1657.          NOTE:  If you choose a new color and nothing happens, the
  1658.          Intensity/Brightness attribute was probably wrong.  Try it
  1659.          again, but this time press F1 to toggle Bright/Normal.
  1660.  
  1661.                                                                          
  1662.          13
  1663.  
  1664.          =========== REPEAT and CUT & PASTE (REGISTERED VERSIONS) =========
  1665.  
  1666.          Repeat  <R>                      Alt-R / Options - Repeat
  1667.          ......
  1668.          Repeat can save you dozens or hundreds of keystrokes.  When you
  1669.          begin an Alt-key design function (ie., box, line, copy/move/
  1670.          erase, etc., but NOT Function key options or UnDo), P-Screen
  1671.          records your actions, then repeats them when you press Alt-R.
  1672.  
  1673.          For example:
  1674.  
  1675.           * You create a box.  You then move the cursor to a new loca-
  1676.             tion and press Alt-R.  P-Screen draws another box in the
  1677.             new location -- same style, same size, same colors.
  1678.  
  1679.           * Or suppose you want a grid (a series of horizontal lines).
  1680.             You draw the first line.  You then move the cursor down 3
  1681.             lines and press Alt-R.  P-Screen draws another line for
  1682.             you.  You move down 3 more lines and press Alt-R again;
  1683.             then again, and again and....
  1684.  
  1685.          You can Alt-<R>epeat something as many times as you like.
  1686.          But, as soon as you begin the next Alt-key option, P-Screen
  1687.          starts recording your actions again.  If you then Cancel it
  1688.          (ie., press <Esc>), you may have to start over.
  1689.  
  1690.  
  1691.          Cut & Paste  <R>        Alt-K, Alt-L / Block - Cut/Paste
  1692.          ............
  1693.          Cut & Paste also saves enormous time.  They let you easily:
  1694.           * copy a section of one screen to a different screen
  1695.           * copy a section to other locations in the same screen
  1696.  
  1697.          To copy a section of a screen, move to the one corner of an
  1698.          area and press Alt-K.  Move to the opposite corner; press <cr>.
  1699.           * P-Screen copies the portion of the screen you marked to a
  1700.             "clipboard."  Your existing screen is unchanged.
  1701.           * It may seem that nothing happened -- the clipboard is
  1702.             "invisible."   But, just press Alt-L and P-Screen "pastes"
  1703.             the block back on your screen.
  1704.  
  1705.          You can now clear the screen, load another one, or move to a
  1706.          different location.  Press Alt-L to "paste" the clipboard con-
  1707.          tents onto the current screen, starting wherever your cursor is.
  1708.           * In other words, you can paste the contents of the clipboard
  1709.             anywhere on your screen -- not just to it's original location.
  1710.           * If you don't like the way it looks, press Alt-U (undo), then
  1711.             move the cursor and press Alt-L to paste it somewhere else.
  1712.           * NOTE:  "paste" ALWAYS pastes from wherever your cursor is
  1713.             down and right (regardless of how you "marked" the block).
  1714.             So, before pressing Alt-L, ALWAYS move the cursor to the top
  1715.             left corner of where you want the clipboard contents pasted.
  1716.  
  1717.          Like Alt-R, you can press Alt-L (Paste) as many times as you want.
  1718.          Each time, P-Screen pastes the contents of the clipboard onto your
  1719.          screen at the cursor.  Alt-R and Alt-L can serve the same purposes.
  1720.  
  1721.                                                                             
  1722.          14
  1723.  
  1724.          =========== FORMAT        P-SCREEN PROFESSIONAL (PS PRO) =========
  1725.  
  1726.          Press Alt-F to "format" fields on a screen and ask PS Pro to
  1727.          write your QuickBASIC data entry programs for you.
  1728.  
  1729.                                    Overview
  1730.                                    ========
  1731.          PS Pro lets you define up to 100 separate "fields" on each
  1732.          screen.  That's a lot.  But if you need more, just edit the
  1733.          ".BAS" file PS Pro creates; duplicate or add as many as you like.
  1734.  
  1735.          Most data input screens have, basically, two types of fields.
  1736.  
  1737.           * Input Fields        Fields we fill out:  Date, Name, Phone #,
  1738.                                 Social Security #, # of Hours Worked, etc.
  1739.  
  1740.           * Calculated Fields   Examples:  Total Wages (Normal Wages plus
  1741.                                 Overtime), Purchase cost (Quantity times
  1742.                                 Price), Sales Tax (Subtotal times tax rate).
  1743.                                 - You can create virtually ANY calculated
  1744.                                   field using standard BASIC equations.
  1745.                                 - These equations often (but don't have to)
  1746.                                   use data entered in Input fields.
  1747.  
  1748.          The distinction between "Input" and "Calculated" fields is im-
  1749.          portant.  First, the programs PS Pro writes let you enter
  1750.          information in Input fields but not in Calculated fields (edit
  1751.          your ".BAS" files to change this).  Second, you can supply
  1752.          "format strings" to format: 1) how input fields are edited
  1753.          (using rsMinput); or, 2) how calculated fields are printed
  1754.          (using FormatUsing).  rsMinput and FormatUsing use format
  1755.          strings differently.  We'll discuss these differences shortly.
  1756.  
  1757.  
  1758.          Logically, here are the steps you follow to format a screen
  1759.          and have PS Pro write your programs for you.  For each field:
  1760.           1. Mark the beginning and end (press Alt-F at the left side,
  1761.              move to the right side and press <cr> -- like painting it)
  1762.           2. Give it a name.
  1763.  
  1764.          That's the minimum you have to do.  But, to take full advantage
  1765.          of PS Pro's power and the subroutines we provide, you can also:
  1766.  
  1767.           3. Choose a field type (String, Date, Integer, Currency, etc.).
  1768.           4. If appropriate, tell PS Pro how many decimal places it has.
  1769.           5. Enter a "format string" to format editing or printing.
  1770.           6. If you want PS Pro to "validate" user input, tell PS Pro
  1771.              the Minimum and Maximum values to accept.
  1772.           7. If you want a help screen attached to the field, tell
  1773.              PS Pro which screen library it's in, and what its name is.
  1774.           8. If it's a calculated field, enter a formula.
  1775.  
  1776.           Then, when each field on your screen is formatted, just press
  1777.           a key to ask PS Pro to write your program for you.
  1778.  
  1779.          We'll first discuss the general procedures for formatting fields.
  1780.          We'll then present an example.
  1781.                                                                             
  1782.          15   Alt-F Format (continued)
  1783.  
  1784.                            The Field Format Window
  1785.                            =======================
  1786.          Suppose the first field on your screen was Date.  To format it:
  1787.           * Move the cursor to the left side of where we want to begin
  1788.             entering a date.  Press Alt-F.  A blinking "F" appears.
  1789.           * Now move the cursor right to the end of the field; press <cr>.
  1790.             NOTE:  ALWAYS move Left to Right for begin formatting fields!
  1791.           * A "Field Format" window pops up.  It looks like this.
  1792.  
  1793.          +-Field #:   |-------------------|Row:      Column:      Length:   -+
  1794.          |                                                                   |
  1795.          |       +-----------+            +--+---------+                +----+
  1796.          |  Name |           | Field Type |  |         | Decimal Places |    |
  1797.          |       +-----------+ F10 = Menu +--+---------+ (0 - 15)       +----+
  1798.          |       +------------------+     +------------------+               |
  1799.          | Range |                  | --- |                  |               |
  1800.          |       +------------------+     +------------------+               |
  1801.          |       +------------------------+                         +--------+
  1802.          |Format |                        |     Help Screen Library |        |
  1803.          |       +------------------------+                         +--------+
  1804.          |       # (###) ### - #### for phone #s        Screen Name |        |
  1805.          |                                                          +--------+
  1806.          +Formula -----------------------------------------------------------+
  1807.          |                                                                   |
  1808.          +-------------------------------------------------------------------+
  1809.          |F1 = Help  F6 = Name (Formulas)  F8 = Dup   F2 = Save   Esc = Quit |
  1810.          +-------------------------------------------------------------------+
  1811.          The field format window has 3 basic sections:  Top Line, Bottom
  1812.          Line, and the "Middle Boxes" which tell PS Pro how to treat fields.
  1813.  
  1814.          TOP LINE:
  1815.           * Field #        The number of the field you're formatting (1-100)
  1816.  
  1817.           * Row & Column   The row and column of this field on your screen
  1818.  
  1819.           * Length         The width of the field (# of columns you marked
  1820.                            after pressing Alt-F).  Length governs how many
  1821.                            characters users can enter in this field.
  1822.          BOTTOM LINE:
  1823.           * F1 Help        To get help with filling in any box, move the
  1824.                            cursor to that box and press F1.
  1825.  
  1826.           * F6 Name        Used only when entering Formulas.  More later.
  1827.  
  1828.           * F8 Dup         Once you enter a name for a field, press F8
  1829.                            to duplicate OTHER information from fields
  1830.                            you already formatted.  This is useful to
  1831.                            copy format strings, formulas, etc., ensuring
  1832.                            consistency and accuracy across identical fields.
  1833.  
  1834.           * F2 Save        After you've defined all fields on your screen,
  1835.                            press F2 to ask PS Pro to write your program.
  1836.                            - The program name is the screen name, plus ".BAS"
  1837.                            - Be sure there's AT LEAST 15k bytes of free
  1838.                              disk space on the CURRENT drive before you
  1839.                              begin formatting a screen.
  1840.  
  1841.           * Esc = Quit     Press Esc to return to your screen.              
  1842.  
  1843.          16   The Field Format Window (continued)
  1844.  
  1845.          MIDDLE BOXES:
  1846.           * Name           The name of this field.  Each name MUST be unique.
  1847.  
  1848.           * Field Type     One of 13 different field types:  String, Proper
  1849.                            Name, Date, Zip Code, Currency, etc.
  1850.  
  1851.           * Decimals       The number of decimal places to use for Single
  1852.                            or Double precision numbers or Currency.
  1853.  
  1854.           * Range          If you want PS Pro to validate user input, enter
  1855.                            the Minimum and Maximum values for a field.
  1856.  
  1857.           * Format         "Format strings" are used to both format editing
  1858.                            and print calculated fields.
  1859.  
  1860.           * Help Library/  To link a help screen to any field, just supply
  1861.             Screen         a library name and a screen name.
  1862.  
  1863.           * Formula        Create calculated fields by entering any valid
  1864.                            QuickBASIC formula, using any combination of
  1865.                            field names, constants or intrinsic functions.
  1866.          CAUTION
  1867.          .......
  1868.          Once you format a screen, BE SURE to press F2 Save from the Field
  1869.          Format window BEFORE you load another screen or press F6 New/Clear.
  1870.          Clearing the screen or loading another one (even a sub-screen) re-
  1871.          initializes the field format process, erasing any work in progress.
  1872.  
  1873.          You CANNOT edit the information on the Top Row.  But you CAN
  1874.          change the Length of a field.  Do this by returning to your
  1875.          screen and moving to the same row/column and pressing Alt-F.
  1876.          Move the cursor right and press <cr>.
  1877.           * Each time you format a field, PS Pro checks to see if you've
  1878.             already defined a field starting at this row/column.
  1879.           * If you have, PS Pro beeps, and displays any information you
  1880.             already entered for this field.  You'll see that Length
  1881.             changed (assuming you marked a different # of columns).
  1882.  
  1883.  
  1884.          Here's an example of how to format a screen.  This example uses
  1885.          the screen "Employee" found in P-Screen.Psl.  It's the basis for
  1886.          Employee.Bas, one of your demo programs written entirely by PS Pro.
  1887.  
  1888.                       +---- xyz Corporation  Salary Summary ----+
  1889.                       |                                         |
  1890.                       |           DATE:                         |
  1891.          ---------------------------------------------------------------------
  1892.                       |Social Sec.|Hourly|# Hours Worked|   Wages *   |
  1893.          Name         |   Number  | Wage |Normal  O'Time|Normal O'Time| Total
  1894.          -------------+-----------+------+--------------+-------------+-------
  1895.                       |           |$     |              |             |
  1896.          -------------+-----------+------+--------------+-------------+-------
  1897.                       |           |$     |              |             |
  1898.          -------------+-----------+------+--------------+-------------+-------
  1899.          * Overtime wages are "time & 1/2"       Totals:|
  1900.            (1.5 times Normal wage rate)                 +--------------------- 
  1901.  
  1902.  
  1903.          17   Alt F:  An Example (continued)
  1904.  
  1905.          "Employee" is a simple weekly salary summary for the xyz Corp.
  1906.          When we fill out this screen, we'll enter certain information
  1907.          (Date, Employee Name and Social Security #, Number of Hours
  1908.          worked, etc.).  The formulas we create handle the rest.
  1909.          Formulas calculate Wages (Hours Worked times Hourly Wage),
  1910.          Total Wages for each employee, and Totals for all employees.
  1911.          Run Employee.Bas in QuickBASIC 4.x to see this in action.
  1912.  
  1913.          Field Name
  1914.          ..........
  1915.          The first step in formatting a field is to give it a name.  This
  1916.          is required before you can enter anything else.  Since DATE is
  1917.          our 1st field above, we enter "TodaysDate" as our field name.
  1918.           * Field names can have 1-13 characters.  They'll become
  1919.             variable names in a USER TYPE that PS Pro creates.
  1920.           * All field names must be unique (up to you, PS Pro WON'T check)
  1921.           * Field names should:
  1922.             - NOT be QuickBASIC reserved words.  For example, avoid
  1923.               things like "Name" or "Date."  We used "TodaysDate."
  1924.             - NOT contain any punctuation.  Use ONLY letters or numbers.
  1925.               Upper or lower case is fine.
  1926.           * To cancel the formatting of a field, press Esc before you've
  1927.             entered a field name.
  1928.  
  1929.  
  1930.          Three sections of the Format Window are highly related:  Field
  1931.          Type, Decimal Places and Format.  Your choice of Type and Decimal
  1932.          Places affect Format.  Please read the next 3 sections carefully.
  1933.  
  1934.          Field Type
  1935.          ..........
  1936.          PS Pro supports 13 field types, shown to     +--------------------+
  1937.          the right.  Your choice of field type        |  1 String          |
  1938.          governs how PS Pro formats a field, and      |  2 Upper Case      |
  1939.          which keys it will consider "valid."         |  3 Proper Name     |
  1940.           * The default field type is "string."       |  4 Date            |
  1941.             String fields are not formatted, and      |  5 Phone Number    |
  1942.             users will be able to enter any keyboard  |  6 Zip Code        |
  1943.             character -- ALL characters are "valid."  |  7 Social Sec. #   |
  1944.                                                       |  8 Numbers Only    |
  1945.           * The field type you choose affects which   |  9 Integer         |
  1946.             keys PS Pro will consider "valid" when    | 10 Long Integer    |
  1947.             users edit that field.  For types 1-3,    | 11 Single Precision|
  1948.             any keyboard character may be pressed.    | 12 Currency        |
  1949.             Field types 4-13 are "Numbers Only"       | 13 Double Precision|
  1950.             fields:  users may press 0-9 and "-+.$"   +--------------------+
  1951.  
  1952.          You may choose a field type in two ways.
  1953.           * Press F10 wherever you are on the Format Window.
  1954.             - A small window pops up like the one shown above.
  1955.             - Use Up/Down cursor keys to highlight your choice.
  1956.               Press <cr> to accept it.  Press Esc to cancel.
  1957.           * The second way to choose a field type is to move the cursor
  1958.             to the Field Type section and type in a number from 1-13.
  1959.           * Either way, PS Pro displays the number and name next to
  1960.             "Field Type."                                                    
  1961.  
  1962.  
  1963.          18   Alt F:  An Example (continued)
  1964.  
  1965.          In our example, we choose the "Date" field type for our first field.
  1966.          When we did, PS Pro printed "## - ## - ####" in the Format box.
  1967.          This "format string" will be used by rsMinput to format editing.
  1968.  
  1969.          * PS Pro automatically "formats" certain fields types.  When
  1970.            we choose one of these, PS Pro prints a "format string" in
  1971.            the "Format" section of the Field Window.
  1972.  
  1973.           * We'll come back to format strings shortly.
  1974.  
  1975.          Decimal Places
  1976.          ..............
  1977.          If a field type is Single Precision, Currency or Double Precision,
  1978.          you can specify the number of decimal places (0 - 15; Decimal
  1979.          Places is ignored for other field types).  For example, you
  1980.          would normally specify 0 or 2 decimal places for Currency.
  1981.  
  1982.          Format
  1983.          ......
  1984.          Format strings are used by both rsMinput and FormatUsing.
  1985.          They are essential to PS Pro's advanced features.
  1986.           * rsMinput uses them for "formatted editing," making it easy
  1987.             to correctly enter things like Zip Codes, Dates, etc.  We
  1988.             refer to this as "masked input" -- input using a mask.
  1989.           * FormatUsing uses them to format numbers for printing.
  1990.  
  1991.          A format string is something like a BASIC Print Using string.
  1992.          Pound signs (#) indicate where numbers or text will appear.
  1993.          Other characters (parentheses, commas, etc.) help format them.
  1994.          Here are some examples, based on which subroutine uses them.
  1995.  
  1996.           * rsMinput  If you choose certain field types, PS Pro will
  1997.             offer "masks" like these:  Date (## - ## - ####), Social
  1998.             Security Number (### - ## - ####), Phone (# (###) ### - ####),
  1999.             or Zip Code (##### - ####).
  2000.             - When entering data in one of these fields, users will be
  2001.               able to enter numbers only where a "#" appears (actually,
  2002.               rsMinput replaces "#" with more discrete dots).  rsMinput
  2003.               automatically skips over spaces, parentheses, hyphens, etc.
  2004.             - You can edit these masks.  Delete them if you prefer that
  2005.               data input not be formatted.  Or delete the spaces if
  2006.               strings are too wide for the field you defined.  Or add
  2007.               any Ascii characters you want to suit your preference.
  2008.             - If rsMinput finds a mask for a field, the mask (not Length)
  2009.               will govern how many characters users can enter in a field.
  2010.  
  2011.           * FormatUsing   If you format a field as a Single or Double
  2012.             Precision number or as Currency, PS Pro will suggest a mask
  2013.             something like "######.##" (assuming you specified 2 decimal
  2014.             places).  Later we'll discuss adding dollar signs (for
  2015.             Currency), commas, etc..
  2016.                                                                             
  2017.  
  2018.          19   Alt-F Format (continued)
  2019.  
  2020.          Format strings are essential to some of PS Pro's advanced features.
  2021.  
  2022.           * Without input "masks," rsMinput can't format data input.
  2023.           * And without format strings, FormatUsing can't right-justify
  2024.             and properly format numbers for printing and editing.
  2025.           * But using them or not is your option.  If you prefer none,
  2026.             just move to the format box, and delete them (press Ctrl-Home).
  2027.  
  2028.          You may edit format strings to serve your needs.  Here's how.
  2029.  
  2030.          Guidelines for Editing Format Strings
  2031.          .....................................
  2032.  
  2033.          First, please understand that PS Pro changes format strings
  2034.          whenever you change the Field Type and the number of Decimal
  2035.          Places.  So, be sure the Field Type and Decimal Places are
  2036.          correct before you invest time customizing the format string.
  2037.  
  2038.          Also understand that rsMinput's "mask" subroutine works differ-
  2039.          ently than FormatUsing.  As a result, format strings for "input"
  2040.          fields must differ from those used for "calculated" fields.
  2041.  
  2042.          Why would you want to edit format strings?
  2043.  
  2044.           * To create a custom format string if PS Pro suggests none.
  2045.             Example:  An Invoice Number ("P~F ### - ####")
  2046.           * To add dollar signs or commas to calculated fields.
  2047.             Example:  For Currency fields, PS Pro might suggest a format
  2048.                       string like "#####.##" (note NO $ or comma).
  2049.                       - Using this format string, a number like "1234.99"
  2050.                         prints just as it looks.
  2051.                       - But edit the format string like this "$####,.##"
  2052.                         and the same number prints like this "$1,234.99."
  2053.                         Note "$" and "," in BOTH the format string and number.
  2054.           * To shorten (remove spaces) or customize a format string.
  2055.             Example:  Date "## - ## - ####" shortened to "##-##-####"
  2056.             Example:  Change Phone or Zip Code formats for non-U.S.
  2057.                       situations.  "### - ###" for Canadian Mail Codes.
  2058.  
  2059.  
  2060.          Editing format strings for "input" fields (ie., for rsMinput)
  2061.          .............................................................
  2062.           * Press "#" where you want to enter text or numbers.
  2063.           * Add other characters like spaces, hyphens, and parentheses
  2064.             for "visual formatting."
  2065.             - rsMinput skips over these characters during editing.
  2066.             - Do NOT add periods to Number-Only fields like Currency.
  2067.               The Mask routine can't handle them properly.  When
  2068.               editing fields like Currency, we'll print them properly,
  2069.               but you must enter the period manually.
  2070.  
  2071.          NOTE:  When you press <cr> or Esc to exit rsMinput, we strip
  2072.          the mask from whatever you're editing.  For example, suppose
  2073.          you were entering a phone number.  On the screen it looks like
  2074.          (123) 456-7890.  When you press <cr>, rsMinput returns 1234567890.
  2075.  
  2076.                                                          continued . . .  
  2077.  
  2078.          20   Editing Format Strings (continued)
  2079.  
  2080.  
  2081.          Editing format strings for "calculated" fields (for FormatUsing)
  2082.          ................................................................
  2083.           * Use any character that's valid in BASIC's Print Using state-
  2084.             ment.  Please consult a BASIC manual for complete details.
  2085.  
  2086.           * "#" represents each digit position.  If the number to be
  2087.             printed has fewer digits than the number of positions spec-
  2088.             ified, the number is right-justified in the field.
  2089.  
  2090.           * "$" causes a dollar sign to be printed at the far left of
  2091.             the field (eg., "$  12345.00").  "$$" causes a dollar sign
  2092.             to be printed to the immediate left of the number (eg.,
  2093.             "$12345.00").  "$$" also adds another digit position.
  2094.  
  2095.           * "." prints a decimal point.
  2096.  
  2097.           * A comma just left of the decimal point causes a comma to be
  2098.             printed to the left of every third digit left of the decimal.
  2099.  
  2100.           NOTE:  You can add "$", "," and other format characters in
  2101.           two ways:
  2102.            1) Replace one of the "#" in your string
  2103.            2) Add them to the string (ie., lengthen the format string)
  2104.  
  2105.           Adding format characters widens your format string.  This may
  2106.           cause numbers to expand beyond the boundaries of the field
  2107.           you defined.  Printed results may be unpredictable.  So we
  2108.           urge you to experiment -- enter the largest possible numbers,
  2109.           then press F9 Calculate to see how results print.
  2110.  
  2111.  
  2112.  
  2113.          Here are some examples of how FormatUsing formats the same
  2114.          number (12345.99) differently depending on your format string.
  2115.  
  2116.                            FormatUsing
  2117.          Format String       Returns       Please Notice:
  2118.          =============     ===========     ===============================
  2119.              ########      12346           NO decimal; 12345.99 is rounded
  2120.             ######.##      12345.99
  2121.            $######.##      $ 12345.99      The space after "$"
  2122.           $$######.##       $12345.99      Two "$$" and NO space after "$"
  2123.           $######,.##      $12,345.99      The comma every 3rd digit left
  2124.                                            of the decimal point.
  2125.                                                                            
  2126.  
  2127.          21   Editing Format Strings (continued)
  2128.  
  2129.  
  2130.          Final notes on format strings (in general)
  2131.          .............................
  2132.           * Format strings may up to 24 characters long -- because BASIC'S
  2133.             Print Using (and therefore FormatUsing) returns an "Illegal
  2134.             function call" error if the number of digits exceeds 24.
  2135.  
  2136.  
  2137.          Final notes on format strings (Input fields, rsMinput)
  2138.          .............................
  2139.           * Some types of fields should be right-justified before
  2140.             calling rsMinput.  PS Pro uses RSET to handle this for you
  2141.             with fields like Phone #.  Here's why RSET is important.
  2142.             - Phone # format strings look like: "(###) ### - ####"
  2143.               Notice the 10 "digit positions" in this format string.
  2144.             - But suppose you enter only 7 digits and leave the area code
  2145.               blank.  When these 7 digits are RSET in a 10 character
  2146.               string, rsMinput prints them properly:  (...) 123 - 4567.
  2147.               If they were NOT RSET, rsMinput would print (123) 456 - 7...
  2148.             - On the other hand, Zip Codes should NOT be RSET.
  2149.             - To decide whether to RSET or not, you must decide which
  2150.               part of the field is "optional" and which is "mandatory."
  2151.               -- If the FIRST part of a field is optional, RSET it.
  2152.                  In Phone #s, the area code (the 1st part) is optional.
  2153.               -- But in Zip Codes the 1st part is mandatory and the
  2154.                  extension is optional.  So we don't RSET Zip Codes.
  2155.  
  2156.           * If rsMinput finds a mask for a field, the number of "#"
  2157.             found in the mask (not the variable "Length") will govern
  2158.             how many characters a user can enter in that field.
  2159.  
  2160.          NOTE:  We mentioned earlier, and we emphasize here that rsMinput
  2161.          strips masks from whatever you're editing, returning only the
  2162.          characters entered.  When entering phone numbers, you'll see
  2163.          "(123) 456-7890" on the screen.  But, rsMinput returns 1234567890.
  2164.          When entering Zip Codes, you'll see "12345 - 9999" on the
  2165.          screen.  But, rsMinput returns 123459999.  rsMinput returns
  2166.          the "real" value; the mask is used only to help format editing.
  2167.  
  2168.  
  2169.          Final notes on format strings (Calculated fields, FormatUsing)
  2170.          .............................
  2171.           * FormatUsing always rounds numbers as necessary.  You control
  2172.             this by the number of digit positions in your format string.
  2173.  
  2174.           * If you ever see "%" printed in front of a number means an
  2175.             error occurred -- the number was too large for the format
  2176.             string or field you created.  Usually this occurs because:
  2177.             - You designed a field too narrow for the number we found.
  2178.             - Or, you added dollar signs or commas to a format string
  2179.               which caused the number to expand beyond the limits of the
  2180.               field you defined.
  2181.  
  2182.           * If your format string has too few digit positions, or if
  2183.             your field is too small for a number, the field may mis-print.
  2184.  
  2185.                                                                           
  2186.  
  2187.          22   Alt-F Format (continued)
  2188.  
  2189.  
  2190.          We'll now discuss the final three areas of the Field Format
  2191.          Window:  Range, Help and Formulas.
  2192.  
  2193.  
  2194.          Range
  2195.          .....
  2196.          If you want PS Pro to validate user input, you must enter BOTH
  2197.          Minimum and Maximum values next to Range.  If either is blank,
  2198.          PS Pro will skip the validation.
  2199.           * For string fields (String, Proper Name, Upper Case):
  2200.             - The minimum value might be "1" or "A" -- the smallest
  2201.               or "lowest" alphanumeric value (in most cases).  This
  2202.               would catch situations where users enter nothing when
  2203.               something is required.
  2204.             - The maximum value might be "zzzzzzzzzzzzzzzz" or any
  2205.               "value" that logically users should not exceed.
  2206.  
  2207.           * For numeric fields, enter the lowest and highest numeric
  2208.             values you'll accept.  PS Pro evaluates any "numbers only"
  2209.             field as double precision numbers -- so 9 or 10 digit
  2210.             numbers like Phone Numbers or Zip Codes won't cause
  2211.             "Overflow" errors.
  2212.  
  2213.  
  2214.          Adding "Context Sensitive" Help to your Programs
  2215.          ................................................
  2216.          If you want PS Pro to link a help screen to a field, just
  2217.          enter a Screen Library Name and a Screen Name.
  2218.           * The programs PS Pro writes use F1 to call help screens.
  2219.             To use a different "Help Hot Key", just edit the program.
  2220.           * Each time F1 is press, the program PS Pro writes checks
  2221.             to see if the screen library exists on the CURRENT drive
  2222.             (by CALLing the subprogram "Exists" that we supply).
  2223.             - You could edit the program to "CALL Exists" at the
  2224.               beginning of your program.  Then, if the screen library
  2225.               doesn't exist on the current drive, either abort or ask
  2226.               the user to specify the path to the screen library.
  2227.  
  2228.          If you enter a screen name that doesn't exist, when you run
  2229.          your program and press F1, your program will just beep and
  2230.          return to the editing routine.
  2231.  
  2232.                                                                         
  2233.          23   Alt-F Format (continued)
  2234.  
  2235.          Formulas
  2236.          ........
  2237.          Enter any valid QuickBASIC formula in the Formula box.  Enter
  2238.          NOTHING but formulas in the Formula box.  If ANYTHING is in the
  2239.          Formula box, we'll treat that field as calculated (can't edit it).
  2240.           * Results of formulas are printed according to the field type
  2241.             and format string for this field.
  2242.           * PS Pro-written programs display results of formulas either:
  2243.             - When users press F9 (the "calculate key" of many spreadsheets).
  2244.             - Or, after users edit the last "input" field.
  2245.             - Edit these programs to change when calculations occur.
  2246.           * Formulas can include "qualified field names," constants, and
  2247.             any QuickBASIC intrinsic function (eg., VAL, trigonometric
  2248.             functions, INSTR, etc.).
  2249.             - "Qualified field names" MUST include the Screen name, a
  2250.               period, then the field name.  That's because PS Pro
  2251.               creates a USER TYPE defined as the screen name plus
  2252.               individual field names you assigned.
  2253.             - In Employee.Bas you'll see a formula something like this:
  2254.  
  2255.               Employee.TotalWages = Employee.TotalWage1 + Employee.TotalWage2
  2256.                   where:
  2257.                      TotalWage1   is the total weekly wages for person 1
  2258.                      TotalWage2   is the total weekly wages for person 2
  2259.                      TotalWages   is the sum of both of these
  2260.  
  2261.          NOTE:  It can be tedious to constantly type "ScreenName." as part
  2262.          of each variable in a formula.  But, you DON'T have to.  Just
  2263.          press F6 when entering formulas and P-Screen inserts it for you.
  2264.  
  2265.          Here are some sample formulas from the demo program ToOrder.Bas.
  2266.  
  2267.          ToOrder.Total1 = ToOrder.Quantity1 * (the price)
  2268.  
  2269.           * For each product someone orders, the total price is the
  2270.             number of that product they order (Quantity1) times its price.
  2271.  
  2272.           * If product #1 cost $45 per unit, and they ordered 3,
  2273.             ToOrder.Total1 = 3 * 45   (or  $135)
  2274.  
  2275.  
  2276.          ToOrder.Tax = (ToOrder.SubTotal * .065) * INSTR("Y", ToOrder.Taxable)
  2277.  
  2278.           * ToOrder.Bas asks us "Is this sale taxable?" (ToOrder.Taxable)
  2279.             If it is (the person ordering lives in our state), we press
  2280.             <Y>es.  We use this response to help calculate Sales Tax.
  2281.  
  2282.           * Assume the sales tax rate in our state was 6.5% (.065).
  2283.  
  2284.           * To calculate sales tax (ToOrder.SalesTax), we first multiply
  2285.             the subtotal by the tax rate (.065).  We then multiply
  2286.             the resulting product by INSTR("Y", ToOrder.Taxable).
  2287.              - If we had pressed <Y>es (this IS a taxable sale), our
  2288.                INSTR statement would return 1.  One times Sales Tax
  2289.                equals Sales Tax.
  2290.              - But if we had pressed <N>o (this is NOT a taxable sale),
  2291.                our INSTR statement would return 0.  Zero times Sales Tax
  2292.                equals 0 -- or NO sales tax.                                  
  2293.  
  2294.          24
  2295.  
  2296.          =========== FINE-TUNING THE PROGRAMS WRITTEN BY PS-PRO ===========
  2297.  
  2298.          Feel free to edit the programs PS Pro writes to suit your needs
  2299.          or programming preferences.  And there may be several ways you
  2300.          can "tighten them up" (make them more efficient).
  2301.  
  2302.          Subroutines
  2303.          ...........
  2304.  
  2305.          PS Pro's programs include several GOSUBs to handle important
  2306.          chores.  Depending on options you chose, you may or may not
  2307.          need them.  Delete those you don't need.
  2308.  
  2309.          Suboutine          Purpose
  2310.          --------------     --------------------------------------------
  2311.          DisplayHelp        Displays your main screen and help screens.
  2312.          GetColor           Determines the color at each field location.
  2313.                             Supplies rsMinput with two colors:  HiLite
  2314.                             (the highlighted color during edit) and Colr
  2315.                             (the original color to restore on exit).
  2316.  
  2317.                             - If these colors never change, use constants
  2318.                               in rsMinput, or assign them at the beginning
  2319.                               of your program.  Delete references to GetColor.
  2320.  
  2321.          ConvertNumber      For numeric fields, determines the length of
  2322.                             the temporary edit variable -- based on either
  2323.                             the Length of your field or the Format String.
  2324.  
  2325.          Validate           Validates user input.  If valid, assigns
  2326.                             values to your field variables.
  2327.  
  2328.          DoCalcs            "Executes" your formulas, prints results.
  2329.  
  2330.  
  2331.          Help / Calculate
  2332.          ................
  2333.  
  2334.           * Help screens (if any) are displayed when users press F1,
  2335.             the industry-standard help key.
  2336.  
  2337.           * PS Pro's programs "execute" any formulas you created either:
  2338.             - When F9 is pressed (standard among many spreadsheet programs)
  2339.             - Or, when the user move past the last field you defined.
  2340.  
  2341.           You may change F1 and F9 to any key you prefer.  Two screens
  2342.           in P-Screen.Psl (CursAlt and Function) can help you identify
  2343.           the extended key codes for different keys.  These screens help
  2344.           set up rsMinput (to edit Exit$ according to your needs).
  2345.  
  2346.  
  2347.                                                                            
  2348.  
  2349.          25  Fine-Tuning Programs PS Pro Writes  (continued)
  2350.  
  2351.          Improving Efficiency:  User Type Variables
  2352.          ..........................................
  2353.  
  2354.           * In programs it writes, PS Pro creates a user TYPE consisting
  2355.             of the name of your screen plus the name of each field you
  2356.             defined (eg., ToOrder.SubTotal, EMPLOYEE.TodaysDate).
  2357.  
  2358.           * In this TYPE, each field is treated as a separate entity.
  2359.             - For many fields this is appropriate.
  2360.             - But some fields may be identical to others.  For these,
  2361.               you might want to create a separate User TYPE or array.
  2362.               Then handle identical fields in a separate FOR...NEXT or
  2363.               DO...LOOP section.
  2364.  
  2365.            * For example, Employee.Bas has two nearly-identical fields --
  2366.              representing two people.  This program might benefit by
  2367.              handling these identical sections of our screen in a
  2368.              different way than we treat other fields.
  2369.  
  2370.  
  2371.          Improving Efficiency:  Other Ways
  2372.          .................................
  2373.  
  2374.           * PS Pro handles data input within a DO...LOOP.  At the
  2375.             beginning of the loop, we initialize several variables.
  2376.  
  2377.             - Some of these variables MUST be initialized each time.
  2378.               They're needed by rsMinput, which changes them on exit.
  2379.               These include RetCode and Exit$.
  2380.  
  2381.             - Other variables like LibName$, ScreenName$, Msk$, Minimum$
  2382.               and Maximum$ are set to Nul (""), then reassigned as needed
  2383.               for each field.
  2384.  
  2385.             - If some of these latter variables never change, it would
  2386.               be more efficient to assign them before (rather than inside)
  2387.               the DO...LOOP.  Examples might include:
  2388.  
  2389.               -- LibName$   If you have NO help screens, or if they're
  2390.                             all in the same screen library.
  2391.               -- Minimum$/  If you didn't ask PS Pro to validate user
  2392.                  Maximum$   input, you may delete these variables, and
  2393.                             also delete the few lines of code at
  2394.                             "Validate:" where input is validated.
  2395.  
  2396.  
  2397.          Final Comments on Alt-F
  2398.          .......................
  2399.  
  2400.          To emphasize, we urge you to make sure your screen is a
  2401.          "finished product" before you begin formatting a screen.
  2402.  
  2403.           * Formatting screens can take some time.  If you later change
  2404.             the screen, you may have to re-format it all over, or edit
  2405.             the ".BAS" file PS Pro created.
  2406.                                                                             
  2407.          26
  2408.  
  2409.          ======== FUNCTION KEY OPTIONS: HELP, LOADING/SAVING SCREENS ========
  2410.  
  2411.            F1 = Help      F2 = Save   F3 = Save Sub  F4 = Load    F5 = Print
  2412.            F7 = Big! Font F8 = Mono   F9 = Review   F10 = Options
  2413.  
  2414.          We discussed F10 Options under "Some Basics."  Please refer
  2415.          to that section to understand how to change: line/box draw
  2416.          or shading characters, colors, # of lines on your screen, etc.
  2417.  
  2418.          Help                                (F1 / Help)
  2419.          ....
  2420.          Press F1 to call up the Help Menu.  Help screens are stored in
  2421.          P-Screen.Psl (which is required to run P-Screen).
  2422.  
  2423.           * A menu drops down.  Pick the topic you want help with.
  2424.  
  2425.  
  2426.          Saving and Loading Screens:  A word about Paths
  2427.          ...............................................
  2428.          P-Screen was designed to save and load screens to the "current
  2429.          path" -- the drive and directory you're on when you start
  2430.          P-Screen.  We recommend you stick with this, it's simplest.
  2431.  
  2432.           * But, you can "activate" a different path -- another drive
  2433.             or directory.  Once you do, P-Screen will load and save
  2434.             screens from/to that path, until you change the path again.
  2435.  
  2436.           * To "activate" a different path you have to LOAD a screen from
  2437.             that path.  But, how did it get there?  You copied it there.
  2438.  
  2439.           * Press F4 Load.  Then press L, A or B to tell P-Screen whether
  2440.             you want to load a screen from a Library, or load an Ascii
  2441.             or BSAVE file (NOT graphics).  P-Screen displays this window:
  2442.  
  2443.                    +---------------------------------------------+
  2444.                    | Load Which (Library or Screen)?             |
  2445.                    +---------------------------------------------+
  2446.                    |                                             |
  2447.                    | ........                                    |
  2448.                    |                                             |
  2449.                    + <Esc> = Cancel    F2 = Directory -----------+
  2450.  
  2451.  
  2452.              - Notice the line above "........" is blank.  This means
  2453.                P-Screen is using the "current" drive/directory.
  2454.  
  2455.              - Press F2 Directory.  P-Screen asks "Which Drive?"  Press
  2456.                A, B, C, etc.  It then asks "Which Directory?"  Type in
  2457.                a directory name and press <cr>.
  2458.  
  2459.              - P-Screen scans that path for screens/screen libraries.
  2460.                It then displays a menu with all screen (or library)
  2461.                names.  Highlight the one you want; press <cr>.
  2462.  
  2463.              - P-Screen loads your screen, or displays another menu
  2464.                showing which screens are in the Library you chose.
  2465.                                                                            
  2466.  
  2467.          27   A Word About Paths (continued)
  2468.  
  2469.  
  2470.          Now, the next time you Save or Load a file, the line above "......."
  2471.          shows the path you chose.  All saving/loading will be to that path.
  2472.  
  2473.          Sound complex?  It's much easier to do than read about.  Try it.
  2474.          But, you'll simplify things if you store your screens and screen
  2475.          libraries on the drive/directory you keep P-Screen itself.
  2476.  
  2477.          Saving Full or ASM Screens          (F2 / File - Save)
  2478.          ..........................
  2479.  
  2480.          Press F2 to save screens.  If you're saving an ASM screen, BE
  2481.          SURE that, before you press F2, you move the cursor to the top
  2482.          left corner of the area of the screen you want saved.  With ASM
  2483.          screens, you can save anything from 1 character to the whole screen.
  2484.  
  2485.          Press F2 and P-Screen asks if you want to save a screen to a
  2486.          library or save an ASM, Ascii or executable ".Com" screen.
  2487.          Press L, A or C or M.  ("Com" screens, registered users only.)
  2488.  
  2489.           * To save an Ascii or "Com" screen, enter a file name.  Ascii
  2490.             screens are saved as "FileName.PSS."  Executable screens are
  2491.             saved as "FileName.COM."
  2492.  
  2493.           * To save ASM screens, move the cursor to the bottom right corner
  2494.             of the area you want saved,.  Press <cr> then enter a screen name.
  2495.             
  2496.           * When you save a screen to a library, P-Screen asks you for:
  2497.             1) A Library name.  If the library doesn't exist, P-Screen
  2498.                asks:  "Want to create it?"  Press <Y>es or <N>o.
  2499.             2) A 1-8 character screen name
  2500.             3) A 1-15 character description  (optional but very helpful)
  2501.  
  2502.  
  2503.          Saving "Sub" or "Partial" Screens   (F3 / File - Save Partial)
  2504.          .................................
  2505.          Subscreens are partial screens -- a single line, box or
  2506.          rectangle.  They're fast, efficient ways to display menus, help
  2507.          screens, or any partial screen.  They use less disk space, and
  2508.          load faster (there's less to load).  And they pop up right
  2509.          where they were when you saved them.  (You can change where
  2510.          they're displayed.)  You can save them to Libraries only.
  2511.  
  2512.          Press F3 and a blinking diamond appears marking the top left
  2513.          corner of your subscreen.
  2514.  
  2515.           * Move to the bottom, right corner.  Press <cr>/Left mouse button.
  2516.  
  2517.           * Enter a library name, a screen name and a description.
  2518.  
  2519.           * Whether you call up a subscreen from within P-Screen or in
  2520.             your program, it appears where it was when you saved it.  In
  2521.             your programs, you can change where it appears by changing
  2522.             the screen location you restore it to. See "Loading Screens
  2523.             from Your Programs" for details on doing  this.
  2524.  
  2525.                                                                            
  2526.          28 
  2527.  
  2528.          Replacing Library Screens   (or, No Duplicate Names Please)
  2529.          .........................
  2530.          When you save a screen to a library, P-Screen checks to see if
  2531.          the screen name already exists.  If the screen name DOES exist,
  2532.          P-Screen checks to see how large the original screen was.
  2533.  
  2534.           * If there's enough room to save your screen in the same
  2535.             place, P-Screen asks if you want to replace the existing
  2536.             screen.  Say No, and P-Screen starts over, letting you
  2537.             enter a different name.
  2538.  
  2539.           * If there's NOT enough room, P-Screen asks you to start over
  2540.             and enter a different name.  Why?  If you added screens with
  2541.             the same name, you'd never be able to access the 2nd, 3rd, etc.
  2542.  
  2543.  
  2544.          Loading Screens                      (F4 / File - Load)
  2545.          ...............
  2546.          See "A Word About Paths" on the last page.
  2547.  
  2548.          Press F4 and P-Screen asks whether you want to load a screen
  2549.          from a Library, or load an Ascii or BSAVE file.  Press L, A or B.
  2550.  
  2551.           * If you chose Ascii or BSAVE:
  2552.             - Enter a 1-8 character file name (extensions must be
  2553.               ".PSS" for Ascii files, or ".BSV" for BSAVE files).
  2554.  
  2555.             - Or press F2 for a directory.  When asked "Which Drive?" press
  2556.               <cr> for a directory of the drive/directory you're on.  Or,
  2557.               enter a new drive/directory.  Highlight a screen, press <cr>.
  2558.  
  2559.           * If you chose to load a screen from a screen Library:
  2560.             - Enter a 1-8 character Library name, or press F2 for a
  2561.               directory.  Libraries must have ".PSL" extensions.
  2562.  
  2563.             - P-Screen looks for the library on the "active" drive/di-
  2564.               rectory, then displays the names of all screens in that
  2565.               library.  Highlight the screen you want.  Press <cr>.
  2566.  
  2567.             - If you load a subscreen, it appears in the spot where it
  2568.               was when you saved it, overwriting anything that was there.
  2569.  
  2570.  
  2571.          Printing Screens                     (F5 / File - Print)
  2572.          ................
  2573.          When you ask to print, P-Screen asks:  "Translate, or Print As is?"
  2574.  
  2575.           * Press <A>s is if your printer CAN print the line draw,
  2576.             shading and low/high Ascii characters on your screen.
  2577.             P-Screen prints everything you see (except the colors).
  2578.  
  2579.           * Press <T>ranslate and P-Screen translates the line draw
  2580.             characters into characters any printer can handle (+-=|).
  2581.             Most low/high Ascii characters print as "#" or blanks.
  2582.  
  2583.          You can print Ascii screen files in several ways.  Copy it to
  2584.          your printer (eg. "copy myscreen.pss prn").  Or, load one or
  2585.          more into your word processor, then print them.                
  2586.  
  2587.          29
  2588.  
  2589.          We're taking two options out of order:  F8 MakeMono and
  2590.          F9 Directory.  These topics are brief; but the next one,
  2591.          F7 Big! Font is not.
  2592.  
  2593.  
  2594.          Viewing Screens in Monochrome        (F8 / Options - MakeMono)
  2595.          .............................
  2596.          The "View in Monochrome" option was added primarily for use
  2597.          with P~F Presents (PFP).  PFP has an option which lets those
  2598.          viewing your presentations view them in "monochrome."  This
  2599.          option is helpful to those with laptop computers or composite
  2600.          monitors -- which can render colored text unreadable.
  2601.  
  2602.          P-Screens MakeMono option lets you anticipate how screens will
  2603.          look when converted to one of 4 combinations of black and white.
  2604.          It also helps you spot areas of screens that aren't converted
  2605.          correctly -- because you painted only parts of areas, moved or
  2606.          erased things, etc.
  2607.  
  2608.  
  2609.          When you press F8, P-Screen beeps then displays your screen 4
  2610.          times, each time re-mapping the colors to a different combi-
  2611.          nation of white and black.  At the bottom of your screen, it
  2612.          tells you which option is being used.  In PFP, you select which
  2613.          monochrome version you want by using the label "Mono #" where "#"
  2614.          is 1, 2, 3 or 4 (or 0 to display colors).   These options are
  2615.          more fully described in PFP's manual.
  2616.  
  2617.          Press a key to move from screen to screen.   Press Esc to quit.
  2618.          When you're finished, P-Screen restores your screen as it was,
  2619.          letting you continue editing it.
  2620.  
  2621.  
  2622.          Review/Directory                     (F9 / File - Directory)
  2623.          ................
  2624.          Press F9 to review the names and descriptions of screens in
  2625.          a screen library.
  2626.  
  2627.           * Tell P-Screen which library to review.
  2628.  
  2629.           * P-Screen then clears the screen and shows screen names and
  2630.             descriptions side by side.  Press any key to return to your
  2631.             screen.
  2632.  
  2633.          For a printed list of screens and descriptions, press Shift-PrtSc.
  2634.  
  2635.           * BE SURE your printer is ready (we won't check for you).
  2636.  
  2637.           * Press Shift-PrtSc as each "page" of screen names is displayed.
  2638.             100-screen libraries could need 3, 25-line "pages."
  2639.             
  2640.  
  2641.                                                                            
  2642.          30
  2643.  
  2644.          Big! Font                            (F7 / Edit - Big! Font)
  2645.          .........
  2646.  
  2647.          ██████   ████   █████   ██        ███████                   ██
  2648.           ██  ██   ██   ██   ██  ██         ██   █                   ██
  2649.           ██  ██   ██   ██   ██  ██         ██ █    █████  ██████  ██████
  2650.           █████    ██   ██       ██         ████   ██   ██ ██   ██   ██
  2651.           ██  ██   ██   ██ ████  ██         ██ █   ██   ██ ██   ██   ██
  2652.           ██  ██   ██   ██   ██             ██     ██   ██ ██   ██   ██
  2653.          ██████   ████   █████   ██        ████     █████  ██   ██   ████
  2654.  
  2655.          ▐▐▐▐▐▐   ▐▐▐▐   ▐▐▐▐▐   ▐▐       ▐▐▐▐▐▐▐                   ▐▐
  2656.           ▐▐  ▐▐   ▐▐   ▐▐   ▐▐  ▐▐        ▐▐   ▐                   ▐▐
  2657.           ▐▐  ▐▐   ▐▐   ▐▐   ▐▐  ▐▐        ▐▐ ▐    ▐▐▐▐▐  ▐▐▐▐▐▐  ▐▐▐▐▐▐
  2658.           ▐▐▐▐▐    ▐▐   ▐▐       ▐▐        ▐▐▐▐   ▐▐   ▐▐ ▐▐   ▐▐   ▐▐
  2659.           ▐▐  ▐▐   ▐▐   ▐▐ ▐▐▐▐  ▐▐        ▐▐ ▐   ▐▐   ▐▐ ▐▐   ▐▐   ▐▐
  2660.           ▐▐  ▐▐   ▐▐   ▐▐   ▐▐            ▐▐     ▐▐   ▐▐ ▐▐   ▐▐   ▐▐
  2661.          ▐▐▐▐▐▐   ▐▐▐▐   ▐▐▐▐▐   ▐▐       ▐▐▐▐     ▐▐▐▐▐  ▐▐   ▐▐   ▐▐▐▐
  2662.  
  2663.          It you printed this and your printer CAN'T print the "high Ascii"
  2664.          characters, the phrase BIG! Font above is probably a mess.  Sorry.
  2665.  
  2666.          But if you're reading this on your pc, or if your printer CAN
  2667.          print the high Ascii (line draw) characters, you can see how
  2668.          powerful P-Screen's BIG! Font option can be.
  2669.  
  2670.          To print the 2 lines above, we just pressed F7 and typed BIG! Font.
  2671.          We pressed F7 again, then pressed F1 to "Alter the Font."  We
  2672.          chose a different Ascii character, then typed in Big! Font again.
  2673.  
  2674.                                What is BIG! Font?
  2675.                                ==================
  2676.  
  2677.          Normal size characters are fine for many things.  But to get
  2678.          someone's attention, or create an even more impressive display,
  2679.          it sometimes helps to create unique, bold characters.
  2680.  
  2681.           * Creating these characters manually is very tedious and
  2682.             time consuming.  Big! Font eliminates that chore.
  2683.  
  2684.           * With Big! Font, just press F7, type a message, then watch
  2685.             as P-Screen instantly translates it into larger characters
  2686.             -- based on the font file you've loaded.
  2687.  
  2688.  
  2689.          Big! Font is especially useful to users of P~F Presents (PFP).
  2690.          PFP is a desktop presentation system that works in text mode,
  2691.          not graphics.  Because you create screens in text mode, your
  2692.          presentations can be viewed on ANY pc.
  2693.  
  2694.           * But one advantage of graphics presentation systems is
  2695.             their ability to display messages in large, dramatic fonts.
  2696.  
  2697.           * Big! Font now gives you the same type of ability in a text-
  2698.             based system (graphics monitors not required).  You can
  2699.             easily and quickly create introductions, titles, transitions
  2700.             and other bold, impressive screens for your presentations.
  2701.                                                                          
  2702.  
  2703.          31  Big! Font (continued)
  2704.  
  2705.  
  2706.          And kids love Big! Font.  They enjoy typing large letters and
  2707.          altering the fonts to see what happens.  Add Big! Font screens
  2708.          to P~F Presents presentations to create games and exercises.
  2709.  
  2710.          Finally, P-Screen's Big! Font feature lets you:
  2711.  
  2712.          * Use as many different fonts as you want.  Registered users
  2713.            receive several different fonts.  And you can create your
  2714.            own fonts to achieve the effects you want.
  2715.  
  2716.          * Customize fonts in seconds.  Select most any Ascii character
  2717.            from a chart and P-Screen transforms your font into a dif-
  2718.            ferent one.
  2719.  
  2720.          * Quickly load any font file.  Use several fonts per screen.
  2721.  
  2722.                                  BIG! Font Files
  2723.                                  ===============
  2724.  
  2725.          P-Screen comes with several Big! Fonts (one in "user supported"
  2726.          versions).  We created each using standard Ascii characters
  2727.          that ANY pc can display (graphics monitors are NOT needed).
  2728.          Font files must have the extension ".Fnt"
  2729.             BigFont1.Fnt      Complete, bold and tall (7 lines high).  Has
  2730.                               almost all keys found on standard keyboards.
  2731.  
  2732.                    *.Fnt      Capital letters A-Z only.  Several different
  2733.                               font styles, differing in strength and size.
  2734.  
  2735.              BigLogo.Fnt      Not a font but a demonstration of how you
  2736.                               can create symbols or special effects, then
  2737.                               add them to your screens by pressing 1 letter!
  2738.                               It contains 3 "symbols" you add to screens by
  2739.                               simply pressing A, B or C.
  2740.  
  2741.  
  2742.          When you run P-Screen, it looks for BigFont1.Fnt on the
  2743.          "current drive."  If P-Screen finds it, you'll see "Loading
  2744.          BIG! Font" as it's loaded.  If P-Screen can't find BigFont1.Fnt
  2745.          on the current drive, you'll see a message, and the Big! Font
  2746.          option won't be available until you press F7 then F2 to load a
  2747.          font file.
  2748.  
  2749.                                  Using BIG! Font
  2750.                                  ===============
  2751.  
  2752.          To use Big! Font, move the cursor to the top left corner; press
  2753.          F7.  Characters will print right and down, and Big! Fonts over-
  2754.          write everything.  So if a font is 7 lines high (as BigFont1.Fnt
  2755.          is), 7 lines of your screen will be overwritten.  Remember Alt-U!
  2756.  
  2757.          NOTE:  Registered users can enter messages with ALL keyboard
  2758.          characters (upper & lower case, numbers, punctuation, etc.),
  2759.          as long as those characters are included in the font currently
  2760.          loaded.  User-supported versions support upper case letters (not
  2761.          lower case, numbers, punctuation or other keyboard characters). 
  2762.  
  2763.  
  2764.          32  Using Big! Font (continued)
  2765.  
  2766.          Press F7 and P-Screen displays a window like this.  The "current"
  2767.          or "active" font is demonstrated in the top part of the window.
  2768.          You type your message in the bottom part -- where the dots are.
  2769.  
  2770.          +-----------------------------------------------------------------+
  2771.          | ██   ██                                                  █████  |
  2772.          | ███ ███                                                 ██   ██ |
  2773.          | ███████  █████   █████   █████   █████   ██████  █████      ██  |
  2774.          | ██ █ ██ ██   ██  █       █           ██ ██   ██ ██   ██    ██   |
  2775.          | ██   ██ ███████  █████   █████   ██████  ██████ ███████   ██    |
  2776.          | ██   ██ ██           █       █   █   ██      ██ ██              |
  2777.          | ██   ██  █████   █████   █████   ██████  █████   █████    ██    |
  2778.          |-----------------------------------------------------------------|
  2779.          |                                                                 |
  2780.          | Enter your text below -- 1 to 10 characters.                    |
  2781.          |                                                                 |
  2782.          | .................                                               |
  2783.          |                                                                 |
  2784.          +-F1 = Alter Font     F2 = Load Font     Esc = Cancel-------------+
  2785.  
  2786.  
  2787.          When you press F7 you have 3 options:
  2788.  
  2789.           * Enter a message.
  2790.  
  2791.             - P-Screen "estimates" how many Big! Font characters will
  2792.               fit between where your cursor is and either:  1) the right
  2793.               side of the screen; or 2) the first "high Ascii" character
  2794.               it finds (a box, line, Big! Font character, etc.).
  2795.  
  2796.             - When you enter a message and press <cr>, it appears
  2797.               instantly on your screen. If you don't like it, Alt-U
  2798.               restores the screen.
  2799.  
  2800.            * Alter The Font (F1)
  2801.  
  2802.              - Alter Font is a quick way to customize a font.  It works
  2803.                WELL with BigFont1.Fnt and BigLogo.Fnt, but POORLY with
  2804.                BigFont2.Fnt.
  2805.              - Alter Font changes every non-space character in a font
  2806.                to another character you choose.
  2807.              - Press F1 when the Big! Font window is displayed and
  2808.                P-Screen displays the same screen it does when you
  2809.                press Alt-J (Join).
  2810.              - Use cursor keys to choose a new character; then press
  2811.                <cr>.  P-Screen converts the font then redraws the window
  2812.                above so you can see how your new font looks.  If you
  2813.                don't like the result, try again using a different
  2814.                character.
  2815.  
  2816.            * Load A Font  (F2)         (Registered Users only)
  2817.  
  2818.              - Press F2 to load a new font.  P-Screen displays it's normal
  2819.                file window.  Type in a 1-8 letter file name, or press F2
  2820.                to choose from a directory of font names.                  
  2821.          33
  2822.  
  2823.          ==================== TIPS ON USING Big! FONTS ====================
  2824.  
  2825.          Alter Font (F1)
  2826.          ...............
  2827.          When you customize BigFont1.Fnt, try these characters.  We found
  2828.          they work well.  We've listed the Ascii codes below.  When you
  2829.          press F1, P-Screen displays a window of many Ascii characters.
  2830.          The cursor is blinking under one of them.  In the upper right
  2831.          corner of the window, you'll see the character and it's Ascii
  2832.          code.  Try these with BigFont1 (may be unreadable if printed).
  2833.  
  2834.          220(▄) 223(▀) 221(▌) 222(▐) 176-178(░▒▓) 254(■) 240(≡) (or 7/22/249)
  2835.  
  2836.          If you alter BigFont2.Fnt, you may render it unreadable!  To
  2837.          restore it, press F7 and load it again.
  2838.  
  2839.          Remember Alt-U and Alt-K (Clipboard).  If you enter a Big! Font
  2840.          message but don't like the way it looks, just press Alt-U to
  2841.          restore the screen.  Alter the font, or try a different position.
  2842.  
  2843.          And if you're concerned about overwriting part of your screen,
  2844.          you could save your screen, then press F6 Clear.  Experiment
  2845.          with different fonts.  Then use Alt-K to copy the message to the
  2846.          clipboard.  Now load your screen again and press Alt-L to paste
  2847.          your message in.  (Alt-K/Alt-L are available to registered users.)
  2848.  
  2849.  
  2850.          ====================== CREATING Big! FONTS ======================
  2851.  
  2852.          You can create as many Big! Fonts as you want.  Refer to Appendix
  2853.          I for details on how to do so.
  2854.  
  2855.  
  2856.          CREDITS:   Big! Font was inspired by BigPrint by Michael J.
  2857.                     Himowitz.  Michael graciously encouraged others to
  2858.                     use the font (and routines) he offered.  We're
  2859.                     grateful to) Michael, and to Barry Simon and Richard
  2860.                     Wilson whose BigEcho was the basis of BigPrint.
  2861.  
  2862.                                                                           
  2863.  
  2864.          36
  2865.  
  2866.          ====== PF-CAP and MANAGER:  INVALUABLE P-SCREEN ASSISTANTS! ======
  2867.  
  2868.          P-Screen's registered users receive two additional programs.
  2869.          This section explains how to use each.  Also see Ruler.Doc.
  2870.  
  2871.                                     PF-CAP
  2872.                                     ======
  2873.          Description
  2874.          ...........
  2875.  
  2876.          PF-Cap is a small, RAM-resident (TSR) program to take snapshots
  2877.          of TEXT screens (with color) and save them to disk in BSAVE format.
  2878.          Once on disk, load them into P-Screen, then edit and save them.
  2879.          PF-Cap's a handy way to grab screens from other applications.
  2880.  
  2881.           * PF-Cap automatically detects the number of rows on your screen
  2882.             letting you save 80 column by 25-, 43- or 50-row screens.
  2883.  
  2884.           * PF-Cap saves screens in BSAVE format (with '.BSV' extensions).
  2885.  
  2886.  
  2887.          To Use PF-Cap
  2888.          .............
  2889.  
  2890.           * Log onto the drive/directory where you want PF-Cap to save
  2891.             screens.  PF-Cap ALWAYS saves screens to the drive/directory
  2892.             you were on when you first run it!  This is handy.
  2893.             - We often log onto a RAM disk and then run PF-Cap.
  2894.             - We save many screens to the RAM disk, then later load them
  2895.               into P-Screen and save them to screen libraries on disk.
  2896.             - This way we don't fill our disks with unneeded BSAVE screens.
  2897.  
  2898.           * Run PF-Cap by typing:   PF-Cap <cr>.  It consumes 8k of memory.
  2899.             To unload it, type:     PF-Cap /u <cr>.  ("/u" = unload)
  2900.  
  2901.           * To "capture" a screen, press Ctrl-Space.
  2902.             - By default, PF-Cap sequentially numbers each screen,
  2903.               starting with SCR-0001, then SCR-0002, then SCR-0003, etc.
  2904.             - Press <cr> to accept these names, or edit them to create
  2905.               more descriptive names (leave the numbers so we can properly
  2906.               increment them).  DON'T add an extension. We add ".bsv" so
  2907.               P-Screen can recognize them as BSAVE files.
  2908.  
  2909.           * To load these screens into P-Screen, press F4 Load, then
  2910.             press <B>save when P-Screen asks what type of screen to load.
  2911.  
  2912.  
  2913.          Changing PF-Cap's Ctrl-Space Hotkey
  2914.          ...................................
  2915.  
  2916.          We chose Ctrl-Space as a hotkey because few other programs use
  2917.          that combination for internal purposes.  At the time this
  2918.          manual was written, we hadn't developed a version for you to
  2919.          change hotkeys.  Look on the disk we sent for a file called
  2920.          PF-CAP.DOC.  If it's there, it'll tell you how to change
  2921.          hotkeys.  If not, call us.  We may be able to tell you how.
  2922.                                                                              
  2923.          37
  2924.                                      MANAGER
  2925.                                      =======
  2926.          Description
  2927.          ...........
  2928.  
  2929.          Manager is a small program to help you easily build screen
  2930.          libraries by copying screens from one or more other libraries.
  2931.  
  2932.           * You can mark the screens in the order you want them saved to
  2933.             the "output" library.  This is particularly useful if you use
  2934.             P~F Presents.  It lets you group related screens together, mak-
  2935.             ing it easy to add them in "clusters" to presentation agendas.
  2936.  
  2937.           * Manager is the only way you can "delete" screens from a
  2938.             library.  Actually, you don't delete screens.  You mark the
  2939.             screens you want to save, save them to a different library,
  2940.             then delete the old library.
  2941.  
  2942.          BEFORE Running Manager, Do Two Things
  2943.          .....................................
  2944.  
  2945.           1) Get a directory of screen names/descriptions in input libraries.
  2946.              - When you tell Manager which library to read from (which
  2947.                "input library" to use), it shows you a list of 1-100
  2948.                screen names. This list of screen names won't include
  2949.                descriptions. With up to 100 screen names visible at
  2950.                once, it may be hard to remember which screen is which.
  2951.              - So, before running Manager, you might want to run P-Screen
  2952.                and get a "directory" of screen names.  Press F9 and give
  2953.                P-Screen a library name.  The directory displays screen
  2954.                names AND descriptions.  Press Shift-PrtSc to copy the
  2955.                list to your printer (first be sure your printer's ready).
  2956.                Or, jot down the names of those screens you want.
  2957.  
  2958.           2) Check there's enough free disk space.
  2959.              The screen library (or libraries) you want to read from
  2960.              (the "input" libraries) must be on the CURRENT drive/
  2961.              directory.  And Manager will write "output" libraries
  2962.              to the SAME drive/ directory.  The amount of free disk
  2963.              space must equal or exceed the size of the input library.
  2964.  
  2965.          Using Manager
  2966.          .............
  2967.  
  2968.           * Run Manager by typing:   Manager <cr>.
  2969.           * You'll work in a screen that looks like this:
  2970.  
  2971.          +----------------P-Screen  Screen Library Manager----------------+
  2972.          |Input Library:       Output Library:       Confirm:   Esc = Exit|
  2973.          |----------------------------------------------------------------|
  2974.          |             +-------------------------------------+            |
  2975.          |             | Enter INPUT/OUTPUT library name     |            |
  2976.          |             |-------------------------------------|            |
  2977.          |             |                                     |            |
  2978.          |             | --------.PSL                        |            |
  2979.          |             |                                     |            |
  2980.          |             +-<Esc> = Cancel   <F2> = Directory --+            |
  2981.          |                                                                |
  2982.          +----------------------------------------------------------------+  
  2983.                                                                               
  2984.  
  2985.          38  Using Manager (continued)
  2986.  
  2987.           * Manager asks you 3 questions:
  2988.             1) Which library do you want to read from (ie., what's
  2989.                the name of the "input library")?
  2990.  
  2991.             2) What name should I use to create an "Output Library?"
  2992.  
  2993.             3) Do you want to Confirm each screen?  Press <Y>es or <N>o.
  2994.  
  2995.                - Manager always displays each screen before compressing
  2996.                  it and storing it in the output library.  If you said
  2997.                  you want to confirm, Manager will pause and ask you if
  2998.                  you want this screen saved.  Press <Y>es or <N>o.
  2999.  
  3000.           * Answer these questions, and Manager displays ALL screen
  3001.             names in the input library (1-100) and highlights the first
  3002.             one.  Press:
  3003.  
  3004.               Cursor Keys  To move the highlight to another screen
  3005.               Alt-V        To view the screen that's highlighted
  3006.               Space Bar    To mark a screen for inclusion (or to UNmark it)
  3007.               <cr>         To indicate you're all done marking screens,
  3008.                            and want Manager to create the output library
  3009.               Esc          To abort
  3010.  
  3011.             - If you want ALL screens added to the output library,
  3012.               press <cr> BEFORE you mark any screens.
  3013.  
  3014.           * Mark the screens in the order you want them saved.  Just:
  3015.             - Move the highlight to the first screen you want saved and
  3016.               press the Space Bar.  "1" appears next to the screen name.
  3017.             - Move to the next screen and press Space. "2" appears.
  3018.             - Continue this until all screens are marked.
  3019.             - Press <cr> and Manager creates your output screen library.
  3020.  
  3021.           * To UNmark a screen, highlight it and press the Space Bar.
  3022.             - However, once you use a number it's used and gone.  Why?
  3023.               Suppose you mark 10 screens, then unmark #1.  If you then
  3024.               mark another screen, Manager numbers it #11 -- since it
  3025.               can't know if you want it to be #11 or #1.
  3026.  
  3027.           * After all input library screens have been added to the
  3028.             output library, Manager returns to the initial screen.
  3029.             - If you want to add screens from another library to the
  3030.               same output library, just begin the process again --
  3031.               specifying a different input library, but the same
  3032.               output library.
  3033.  
  3034.           * NOTE:  Once you press <cr>, Manager begins adding screens
  3035.             to your output library (asking for confirmation if you
  3036.             requested this).  Once this process begins, you can't stop
  3037.             it.  If you realize you made a mistake, let Manager finish,
  3038.             then start again.  To avoid this, use P-Screen to get a list
  3039.             of screen names and descriptions, and use Manager's Alt-V
  3040.             (View) option frequently.
  3041.  
  3042.                                                                             
  3043.          39
  3044.  
  3045.          ============= DISPLAYING SCREENS FROM YOUR PROGRAMS =============
  3046.  
  3047.          P-Screen offers you two ways to display screens from your
  3048.          programs.  We'll first explain how to display ASM screens.
  3049.          We'll then describe how to display screens from screen libraries.
  3050.  
  3051.          Regardless of how you'll display screens, you must LINK one or
  3052.          more of our subprograms to your programs.  The easiest way to do
  3053.          that is to add our subs to your LIB and Quick Library files.
  3054.          We'll explain how below.  You'll need our "screen-restore" module
  3055.          in all cases.  If you'll display screens from libraries, you'll
  3056.          also need 2 other modules.  Finally, if you want to display bright
  3057.          background screens, you'll need BrightBG.Obj.
  3058.  
  3059.          P-Screen includes these subprograms to display screens from your
  3060.          programs.  (See Appendix II if you use QuickBASIC 3.0.)
  3061.  
  3062.          Name (.obj)  Format             Purpose
  3063.          -----------------------------------------------------------------
  3064.          LoadScrn     QuickBASIC 4.x \   Open library, find screen.
  3065.          LdScrn7      PDS 7.x         >  Call rsLoadBin to load it.
  3066.                                      /   Report errors (if any).
  3067.  
  3068.          rsLodBin     Assembler          Quickly load screens into array.
  3069.          rsCmpRst         "              Display screens (shareware ver.)
  3070.          CompRest         "              Display any size screens (sent
  3071.                                          to registered users)
  3072.  
  3073.          BrightBG         "              Enable bright background screens,
  3074.          -----------------------------------------------------------------
  3075.  
  3076.          Step 1:  To create (or add modules to) your library files:
  3077.          ..........................................................
  3078.  
  3079.          QB 4.x -->  Lib MyLib + LoadScrn + rsLodBin + BrightBG+ rsCmpRst;
  3080.  
  3081.          PDS 7  -->  Lib MyLib + LdScrn7 + rsLodBin + BrightBG + rsCmpRst;
  3082.  
  3083.               (registered users, replace "rsCmpRst" with "CompRest")
  3084.  
  3085.          To create a QuickLibrary file:
  3086.          ..............................
  3087.  
  3088.          QB 4.x -->  Link /q/seg:256  MyLib.Lib, MyQuik, nul, bqlb45;
  3089.  
  3090.          PDS 7  -->  Link /q/seg:256  MyLib.Lib, MyQuik, nul, qbxqlb;
  3091.  
  3092.  
  3093.          Notes:
  3094.  
  3095.           * Replace "MyLib" or "MyQuik" with your own names.
  3096.  
  3097.           * Notice that we "Linked" MyLib.Lib into MyQuik.Lib.  This
  3098.             ensures QB libraries and Quick Libraries are consistent.
  3099.             We also find it easier than specifying lots of ".obj" files.
  3100.             But, you must specify ".Lib" as in "MyLib.Lib" or Link will
  3101.             assume MyLib is an obj file.
  3102.                                                                              
  3103.  
  3104.          40
  3105.  
  3106.          Once you've added our "screen display" modules to your libraries,
  3107.          just add a few lines of code to your program to display screens.
  3108.          The two simplest ways to display screens are:
  3109.  
  3110.              '...display an ASM screen
  3111.              Call MyScreen
  3112.  
  3113.              '...display library screens with a function we'll create below
  3114.              ErrorCode = Display.Screen (LibName$, ScreenName$)
  3115.  
  3116.  
  3117.          Displaying ASM Screens From Your Programs
  3118.          -----------------------------------------
  3119.  
  3120.          To display an ASM screen, you just CALL it!  That's it.  But
  3121.          for this to work, you must first:
  3122.           * Save a screen to an ASM file.
  3123.           * Assemble it (using either MASM or A86, a shareware assembler).
  3124.           * Then LINK both your screen and our "screen-restore" module to
  3125.             your program.
  3126.           * You can also add your assembled screen and our screen-restore
  3127.             module to your quick libraries so you can display screens
  3128.             while developing programs.
  3129.  
  3130.          Please note that ASM screens "call" our screen-restore module
  3131.          to do the actual work!  That means that once you add the screen-
  3132.          restore module to your LIB/Quick Library files or to your
  3133.          programs, you can use them for many different things:  display
  3134.          ASM screens, display library screens, display normal screens
  3135.          you've saved.
  3136.  
  3137.  
  3138.          Here's how easy it is to create and use ASM screens.
  3139.  
  3140.           1. Create a screen in P-Screen and save it to a screen library.
  3141.              We urge you to ALWAYS save screens to libraries so you can
  3142.              easily edit them later.
  3143.  
  3144.           2. Save your screen to an ASM file by pressing <F2> them <M>.
  3145.  
  3146.              - Note:  before you press <F2> move your cursor to the top
  3147.                left corner of the area you want to save.
  3148.  
  3149.              - After you press <M>, move the cursor to the bottom right
  3150.                corner and press <cr>.
  3151.  
  3152.              - Now give P-Screen a screen name.  Do NOT include hyphens
  3153.                or numbers in your screen name.  Neither MASM nor A86 will
  3154.                accept names that begin with numbers or contain hyphens.
  3155.                Use the underscore if you need a separator (e.g. my_scrn).
  3156.  
  3157.              - Let's say you saved a screen named "myscreen."
  3158.  
  3159.                                                                continued . . .
  3160.  
  3161.  
  3162.                                                                            
  3163.          41
  3164.  
  3165.  
  3166.           3. Exit P-Screen and assemble your screen with A86 or Masm:
  3167.  
  3168.                masm myscreen;        -- note the semi-colon
  3169.                     -or-
  3170.                a86 myscreen.asm +o   -- no semi; +o means .OBJ file, not .COM
  3171.  
  3172.              Note:  Masm assumes you're assembling an ".asm" file and
  3173.              doesn't require the ".asm" extension.  But with a86, you
  3174.              MUST specify the ".asm" extension.
  3175.  
  3176.           4. Add one line to display your screen:   call myscreen
  3177.  
  3178.           5. Finally, LINK your screen(s) to your program and run it.
  3179.  
  3180.                bc myprog /o;
  3181.                link /noe myprog + myscreen,,nul,bqlbxx;  (or qbxqlb;)
  3182.  
  3183.  
  3184.          Editing ASM screens
  3185.          ...................
  3186.  
  3187.          As long as you save screens to screen libraries, you can always
  3188.          call them up and edit them.  You can also edit some parts of ASM
  3189.          screens themselves:  you can edit WHERE they're displayed; and
  3190.          you can also choose which screen-restore subprogram you'll be
  3191.          using.  You can't easily edit the screen itself, since it's
  3192.          repre- sented as a mass of integer data statements (eg., 4036,
  3193.          4057,3872).  While this data is theoretically editable, we urge
  3194.          you NOT to edit it.  If you disturb P-Screen's compression
  3195.          coding, you'll destroy your screen.
  3196.  
  3197.          To edit WHERE screens are displayed:  Near the top of each ASM
  3198.          file are screen coordinates that will look like this:
  3199.  
  3200.                 TopLeftRow DW  1          These describe where your screen
  3201.                 TopLeftCol DW  6          will be displayed.  They indicate
  3202.                 BotRhtRow DW  25          the top left corner (1,6 here) and
  3203.                 BotRhtCol DW  75          the bottom right corner (25,75).
  3204.  
  3205.          To display your screen elsewhere, simply change the numbers.  But,
  3206.          BE SURE you're displaying the same number of rows and columns!
  3207.  
  3208.          At the bottom of ASM files you MAY see two Options sections.
  3209.          They affer two different ways to display screens.  The second is
  3210.          able to "mask" colors to let you display colored screens on mono-
  3211.          chrome or Hercules monitors.  As of this writing, the second option
  3212.          is not available.  We added it for use in our P~F Presents program.
  3213.  
  3214.          IF the second option is available (and you choose it), you must
  3215.          also change the "external" declaration near the top of ASM files.
  3216.  
  3217.           * Look for the line:   Extrn CompRestPlus: Far
  3218.  
  3219.           * Change "CompRestPlus" (or "rsCompRest" in shareware versions)
  3220.             to Extrn rsScrnRest2M: Far.
  3221.  
  3222.                                                                            
  3223.          42
  3224.  
  3225.          ===============  A Final Word About ASM Screens  ===============
  3226.  
  3227.  
  3228.          ASM screens are terrific!  They're v-e-r-y fast and easy to
  3229.          use. And since we use one screen-restore routine for everything
  3230.          (library, ASM and normal screen save/restores), using ASM screens
  3231.          adds very little overhead to your programs.
  3232.  
  3233.          But it's sometimes not obvious when, in your programs, one should:
  3234.            1. Draw a screen by simply adding code to your program to do it.
  3235.            2. Use an ASM screen.
  3236.            3. Or display it from a library.
  3237.  
  3238.          Here are some guidelines we're developing in our own programs.
  3239.  
  3240.          1. First, while we're developing programs, we always display most
  3241.             screens from screen libraries, preserving memory for code.  When
  3242.             we compile the program, we simply comment out the CALLs to the
  3243.             library screen display routine, and un-REM the CALL below it to
  3244.             our ASM or in-line screen display routine.  For example:
  3245.  
  3246.             displayscreen ("mylib", "myscreen", errcode)   -- from a library
  3247.             'myscreen                                      -- ASM screen
  3248.  
  3249.  
  3250.          2. Screens that are critical to our program must be IN our program.
  3251.             This includes menus, dialog boxes, warnings or error messages
  3252.             and mandatory help screens.  We display ALL other screens from
  3253.             screen libraries (help screens, introductions or farewell).
  3254.  
  3255.  
  3256.          3. If a screen must be in our program, which is more efficient,
  3257.             drawing it or using an ASM screen?
  3258.  
  3259.             When a screen is simple, it's often most efficient to draw it
  3260.             manually in your program.
  3261.  
  3262.              * Examples might be a window with just a few lines of text.
  3263.  
  3264.              * This also gives you the flexibility to simply change your
  3265.                code to change colors, text or positions.
  3266.  
  3267.             But with complex screens, it's often more efficient to use ASM
  3268.             screens.  That's because complex screens require so much code
  3269.             to vary colors, patterns and textures and locate and print text.
  3270.             In this case, it might be more efficient to CALL, say, a 2000
  3271.             byte OBJ screen than to create it with code.
  3272.  
  3273.  
  3274.          Replacing ASM Screens in Libraries
  3275.          ..................................
  3276.  
  3277.          Suppose you create an ASM screen, assemble it, then add it to
  3278.          your LIB file.  You then decide to change the screen.  So you call
  3279.          it up from the screen library, edit it, then save a new ASM file.
  3280.          Assemble it, then replace the version in your LIB file like this:
  3281.            Lib MyLib -+MyScreen ("-+" means "replace" or "delete then add").
  3282.                                                                            
  3283.  
  3284.          43
  3285.  
  3286.          Displaying LIBRARY Screens From Your Programs
  3287.          ---------------------------------------------
  3288.  
  3289.          For examples on how to display library screens, run PS_Demo.Bas
  3290.          (QB 4.x and PDS 7) or QB3-Demo.Bas.  Be sure to load the
  3291.          appropriate Quick/User Library like this:
  3292.  
  3293.              ** QB 4.0+ **        qb ps_demo /l ps_demo.qlb <cr>
  3294.              ** PDS 7   **        qbx ps-demo /l bc7demo.qlb <cr>
  3295.              ** QB 3.0  **        qb qb3-demo /l qb3-demo.exe <cr>
  3296.  
  3297.  
  3298.          You can display library screens in several different ways.  The
  3299.          easiest way to display screens from a library is with a FUNCTION
  3300.          -- like the one we'll create below.  This function will display
  3301.          sub-screens in the same place they were when you saved them.  We'll
  3302.          later show you how to display sub-screens in different places.
  3303.  
  3304.  
  3305.          Defint a-z
  3306.          Declare FUNCTION Display.Screen (LibName$, ScreenName$)
  3307.  
  3308.          LibName$ = "MyLib":  ScreenName$ = "MyScreen"
  3309.  
  3310.  
  3311.          '...Display.Screen returns 0 (all is OK), or an Error Code.
  3312.  
  3313.          If Display.Screen (LibName$, ScreenName$) then
  3314.  
  3315.             Print "An error occurred.": Beep: End
  3316.  
  3317.          Else
  3318.  
  3319.            '...... continue with your program.
  3320.  
  3321.          end if
  3322.  
  3323.  
  3324.          An error could occur if:
  3325.  
  3326.           1. Your screen library wasn't found           (Error code =  -1).
  3327.  
  3328.           2. The screen you wanted isn't in the library (  "    "   = -99).
  3329.  
  3330.           3. There wasn't enough memory to create an
  3331.              integer array to load your screen into.    (  "    "   = -88).
  3332.  
  3333.  
  3334.          The Display.Screen Function is on the next page.  As you review
  3335.          the code in that function, notice how we:
  3336.  
  3337.           * Test to see if we should "turn on" bright backgrounds.
  3338.  
  3339.           * CALL rsLoadScrn, which returns several variables we then
  3340.             use to display your screen in the correct place.
  3341.  
  3342.                                                                           
  3343.  
  3344.          44
  3345.  
  3346.          Here's what the Display.Screen Function might look like.
  3347.  
  3348.  
  3349.          Defint a-z
  3350.          '
  3351.          '---------------------------------------------------
  3352.          FUNCTION Display.Screen (LibName$, ScreenName$)
  3353.          '        Display a screen it it's original location.
  3354.          '---------------------------------------------------
  3355.  
  3356.            '... assume NO error
  3357.            Display.Screen = 0
  3358.  
  3359.            '... Test to see if there's enough memory for an array big
  3360.            '    enough for your largest screen.
  3361.  
  3362.            ArraySize = 2000                   '2000 for 80 columns by 25
  3363.                                               'rows.  Use 4000 for 80 x 50.
  3364.  
  3365.            If Fre(-1) < ArraySize then        '... if there's not enough
  3366.               Display.Screen = -88            '    memory, abort to caller
  3367.               Exit Function
  3368.            end if
  3369.  
  3370.            Redim Array%(ArraySize)            '... dimension from element 0
  3371.  
  3372.            Call rsLoadScrn (Array%(), LibName$, ScreenName$, Desc$,    _
  3373.                             TopRow, LeftCol, BotRow, RhtCol, ScrnSize, ErrCode)
  3374.  
  3375.            '... a positive or 0 ErrCode means everything went ok.
  3376.            If ErrCode >= 0 then
  3377.  
  3378.               '... If the first element (0) returns NON-Zero, this is
  3379.               '    a bright-background screen.  So CALL BrightBG.
  3380.  
  3381.               If Array(0) then Call BrightBG (1)
  3382.  
  3383.               '... Display our screen --- from element 1 (NOT 0).
  3384.  
  3385.               CALL rsCompRest(TopRow, BotRow, Seg Array%(1))
  3386.  
  3387.               '...registered users would use: : :
  3388.               CALL CompRestPLUS(TopRow, LeftCol, BotRow, RhtCol, Seg Array%(1))
  3389.  
  3390.            else
  3391.               '... an error occurred; return it to the caller.
  3392.               Display.Screen = ErrCode
  3393.  
  3394.            end
  3395.  
  3396.            '... clean up memory (don't need the array any more)
  3397.            Erase Array
  3398.  
  3399.          End Function
  3400.                                                                         
  3401.  
  3402.          45
  3403.  
  3404.          General notes:  (All QB versions)
  3405.          .................................
  3406.  
  3407.          The general logic of displaying a screen is to:
  3408.  
  3409.            * Assign your LibName$ and ScreenName$ variables, and
  3410.              initialize an integer array.
  3411.  
  3412.            * CALL rsLoadScrn to load your screen from a screen library
  3413.              into the array.  If an error occurs, take appropriate action.
  3414.  
  3415.            * If rsLoadScrn tells us this is a bright-background screen,
  3416.              CALL BrightBG (1) to enable it.
  3417.  
  3418.              - If NONE of your screens will have bright backgrounds,
  3419.                you needn't LINK BrightBG.Obj to your programs, and you
  3420.                can ignore references to BrightBG below.
  3421.  
  3422.            * Display your screen (using rsCompRest or CompRestPlus).
  3423.  
  3424.  
  3425.          For example:
  3426.  
  3427.          LibName$ = "MyLib": ScrnName$ = "Help1"
  3428.  
  3429.          '... using the function we created
  3430.          If Display.Screen (LibName$, ScreenName$) then
  3431.             '... An error occured.  Take appropriate action.
  3432.          end if
  3433.  
  3434.  
  3435.          '... or use the full method, to control where to display screens.
  3436.  
  3437.          Redim  Array%(0)         '...rsLoadScrn will ReDim it
  3438.  
  3439.          Call rsLoadScrn (Array%(), LibName$, ScreenName$, Desc$,    _
  3440.                          TopRow, LeftCol, BotRow, RhtCol, ScrnSize, ErrCode)
  3441.  
  3442.          If ErrCode >= 0 then
  3443.             If Array%(0) then Call BrightBG (1)
  3444.  
  3445.             '... Change TopRow, LeftCol, etc. to display screens elsewhere.
  3446.  
  3447.             CALL CompRestPlus(TopRow, LeftCol, BotRow, RhtCol, Seg Array%(1))
  3448.          end if
  3449.  
  3450.                                                            continued . . .
  3451.  
  3452.                                                                            
  3453.  
  3454.          46
  3455.  
  3456.          In the last example, after we call rsLoadScrn, we check the
  3457.          variable "ErrCode." POSITIVE values are fine (size of compressed
  3458.          screen in bytes).  NEGATIVE values mean an error occurred:
  3459.  
  3460.            - 1 = Screen library wasn't found (misspelled or you speci-
  3461.                  fied the wrong drive/directory), or screen had 0 size.
  3462.  
  3463.            -99 = Your screen wasn't in the library (misspelled?).
  3464.  
  3465.          The examples below show how to check ErrCode.
  3466.  
  3467.  
  3468.          To enable bright backgrounds, you must CALL BrightBG (1) at
  3469.          least once in your program.  Remember that bright backgrounds
  3470.          are achieved by displaying blinking FOREground colors, and then
  3471.          instructing your PC to display bright backgounds instead.  This
  3472.          works ONLY on color-capable monitors.  These screens will blink
  3473.          on monochrome or Hercules monitors.
  3474.  
  3475.          Also note that you CANNOT display blinking and bright backgrounds
  3476.          at the same time -- they're mutually exclusive. If, say, a screen
  3477.          is already displayed that has a few blinking colors, and you pop
  3478.          up a bright background sub-screen on top of it, the blinking
  3479.          colors will turn to bright backgrounds.
  3480.  
  3481.  
  3482.           * To "enable" bright backgrounds, pass BrightBG any NON-Zero
  3483.             value.  From then on, any blinking foreground colors will
  3484.             appear as bright backgrounds instead.
  3485.  
  3486.           * To turn bright backgrounds OFF (and enable blinking),
  3487.             CALL BrightBg (0) -- pass it 0.
  3488.  
  3489.  
  3490.          Integers only:  When CALLing P-Screen's subprograms, your
  3491.          screen array and all numeric variables MUST be integers.
  3492.          Disaster awaits you if you do otherwise.
  3493.  
  3494.          If you have any problems, or aren't sure what to do, call us.
  3495.          A few minutes on the phone may save hours of frustration.
  3496.  
  3497.  
  3498.          IMPORTANT:  Because P-Screen compresses screens, you must use
  3499.                      our screen-display subprograms to display library
  3500.                      screens.  Fortunately, these subprograms will dis-
  3501.                      play normal -or- compressed screens.  So you can use
  3502.                      our subprograms for any text screen-display purpose.
  3503.  
  3504.           NOTE:      If you use QuickBASIC 3.0....
  3505.                      - To display screens in QB 3, see Appendix II.
  3506.                      - We offer no QB 3 version of BrightBG.Obj.  If you
  3507.                        create bright-background screens, you can try
  3508.                        the BrightBG.Obj meant for QB 4.x or PDS.  If they
  3509.                        don't work, sorry, you'll have to eliminate the
  3510.                        bright backgrounds.
  3511.  
  3512.                                                                               
  3513.  
  3514.          47
  3515.  
  3516.          More Examples:  QuickBASIC 4+ or PDS 7 ONLY
  3517.          ............................................
  3518.  
  3519.          Here, we'll change the screen corrdinates to display screens in
  3520.          a place different than they were in when we saved them.  Please
  3521.          run PS_Demo.Bas in QB 4 / PDS 7 for screen-display examples.
  3522.  
  3523.          Example 1:
  3524.          ..........
  3525.  
  3526.            Redim  Array%(0)         '...rsLoadScrn will ReDim it
  3527.  
  3528.            LibName$ = "MyLib": ScrnName$ = "Help1"
  3529.  
  3530.            Call rsLoadScrn (Array%(), LibName$, ScreenName$, Desc$,    _
  3531.                             TopRow, LeftCol, BotRow, RhtCol, ScrnSize, ErrCode)
  3532.  
  3533.            If ErrCode >= 0 then
  3534.  
  3535.               If Array%(0) then Call BrightBG (1)
  3536.  
  3537.               '...display our screen 5 lines LOWER than it was.
  3538.  
  3539.               CALL rsCompRest(TopRow + 5, BotRow + 5, Seg Array%(1))
  3540.            end if
  3541.  
  3542.            '...registered users would use: : :
  3543.            CALL CompRestPLUS(TopRow + 5, LeftCol, BotRow + 5, RhtCol, _
  3544.                 Seg Array%(1))
  3545.  
  3546.          Details
  3547.          .......
  3548.  
  3549.          1.  Initialize your array and assign LibName$ and ScrnName$.
  3550.              Then call rsLoadScrn from your QB 4+ or PDS 7 program.
  3551.              - It finds the screen you requested (or reports errors).
  3552.              - It REdimensions the integer array to the size needed.
  3553.              - It calls rsLoadBinary (asm) for fast loading.
  3554.  
  3555.          2.  Call rsCompRest (or CompRestPLUS) to display screens.
  3556.              - Notice in this example, we displayed our screen 5 lines
  3557.                lower than it was when we saved it to our library.
  3558.  
  3559.              - You can freely change TopRow, LeftCol, BotRow and BotCol
  3560.                to display screens wherever you want.  The only caveat is
  3561.                that you MUST restore the SAME number of rows and columns.
  3562.  
  3563.          3.  When you Call rsLoadScrn, you provide:
  3564.  
  3565.                    Array%()     1-dimension INTEGER array.
  3566.                    LibName$     1-8 character library file name.
  3567.                                 - DON'T include extension. We add ".PSL"
  3568.                                 - Include a full path if your library
  3569.                                   is elsewhere. (eg., "B:\MyLib")
  3570.                 ScreenName$     1-8 character Screen Name (no extension)
  3571.                                                    continued . . .          
  3572.  
  3573.          48
  3574.  
  3575.          When you Call rsLoadScrn (continued)
  3576.  
  3577.  
  3578.              rsLoadScrn then returns:
  3579.  
  3580.                    Array%()     Loaded with screen (if no error occurred)
  3581.                                   We:   Redim Array% (1 to Screen Size)
  3582.                                   So:   Restore from Array% (1) NOT 0!
  3583.                       Desc$     Screen Description saved in the library
  3584.  
  3585.              TopRow, LeftCol\   Screen coordinates to restore screen
  3586.              BotRow, RhtCol /
  3587.  
  3588.                    ScrnSize     Size of compressed screen
  3589.                     ErrCode     >=0  = # of bytes loaded or 0 -- no error
  3590.                                 -99  = Screen NOT found in library
  3591.                                 - 1  = Library NOT found; or 0 size screen
  3592.  
  3593.  
  3594.          Example 2:   "Hardcode" names instead of using variables
  3595.          ........................................................
  3596.  
  3597.          Redim Array%(1)
  3598.          Call rsLoadScrn (Array%(), "MyLib", "Help-1", "",     _
  3599.                           TopRow, LeftCol, BotRow, RhtCol, ScrnSize, ErrCode)
  3600.  
  3601.          If ErrCode >= 0 then CALL rsCompRest(TopRow, BotRow, Seg Array%(1))
  3602.  
  3603.  
  3604.         ==============  Final Notes:  All QuickBASIC Versions =============
  3605.  
  3606.          When CALLing P-Screen's subprograms, use any variable names
  3607.          you want (or absolute values in some cases).  The only caveat:
  3608.          be sure to send down the right number of variables, in the
  3609.          right order.  And be sure integers are integers, strings are
  3610.          strings, etc!
  3611.  
  3612.  
  3613.          Restoring Screens to Different Locations
  3614.          ........................................
  3615.          When you CALL rsLoadScrn, it returns "TopRow, LeftCol, BotRow,
  3616.          and RhtCol" -- indicating where the screen was when you saved
  3617.          it (eg., for full screens: "1,1,25,80").  Change TopRow,
  3618.          BotRow, etc. when you CALL our screen restore subprogram to
  3619.          display screens elsewhere. For example:
  3620.  
  3621.           * rsLoadScrn returns "1,1,10,80" -- our screen orginally
  3622.             covered the top of the screen (rows 1-10, columns 1-80).
  3623.             To display it at the bottom instead, just:
  3624.                     Call rsCompRest(16, 25, Seg Array%(1))
  3625.  
  3626.           * Be sure to restore the SAME NUMBER of rows and columns!
  3627.  
  3628.          Need a Directory of Library Screens?
  3629.          ....................................
  3630.          See PS_Demo.Bas for a program showing how to display a directory
  3631.          of screens in a screen library.                                 
  3632.  
  3633.          49
  3634.  
  3635.          ======================= PERFORMANCE HINTS =========================
  3636.  
  3637.          We mentioned earlier that P-Screen uses exactly the same
  3638.          routines your programs will to display screens from libraries.
  3639.          To see how quickly full screens will be displayed, press F1
  3640.          while in P-Screen to view several help screens.  To see how
  3641.          fast sub-screens can be displayed, press Alt-F10 (demo of 7
  3642.          QB-type menus).  (We use CompRestPlus to display subscreens.
  3643.          You receive this when you register.)
  3644.  
  3645.  
  3646.          Where possible, use subscreens
  3647.          ..............................
  3648.          The smaller the screen, the faster it loads and is displayed.
  3649.          Wherever possible, use subscreens to speed up your programs.
  3650.  
  3651.  
  3652.          Save Time-Critical Screens First
  3653.          ................................
  3654.          Screens near the front of screen libraries load faster than
  3655.          screens near the end (it takes DOS longer to find later screens).
  3656.          So, save the screens you need loaded fast first.  MANAGER makes
  3657.          it easy to re-group library screens in any order you want.
  3658.  
  3659.  
  3660.          Load many screens at once; display each when needed
  3661.          ...................................................
  3662.          Nobody wants to wait for menus, help screens or other screens.
  3663.          They should pop up almost instantly.  Although we built P-Screen
  3664.          for speed, the actual speed you get depends on the speed of both
  3665.          your PC and its disk drives.  The biggest handicap:  floppy disks.
  3666.          They're much slower than hard disks.  For example:
  3667.  
  3668.                     Speed of PC:     ----- 8 mhz ------  ----- 16 mhz ------
  3669.                    Type of Disk:     Floppy  Hard   RAM  Floppy  Hard   RAM
  3670.          ====================================================================
  3671.          # of seconds to Load &
  3672.          Display Demo screens:         4.0    1.4    .5     2.7    .3    .1
  3673.  
  3674.           Avg. # seconds/screen:      (.44)  (.15)  (.06)  (.30)  (.03) (.01)
  3675.  
  3676.          Note how floppy disks penalize even 16 mhz PCs.  Do you use floppy
  3677.          disks only?  Screen design is much faster/smoother on a RAM disk.
  3678.          If you use a RAM disk for screen design, be sure to copy your
  3679.          screens and libraries to floppies/hard disk before shutting down.
  3680.  
  3681.          For help screens, some menus, prototypes, etc., even the slowest
  3682.          speeds (which are still fast) may be fast enough.
  3683.  
  3684.          But for time-critical screens, you may want to load several
  3685.          screens into an integer array as your program starts.  Then,
  3686.          when the proper key is pressed, blast the appropriate portion
  3687.          of the array onto the screen.  PS_Demo.Bas has a complete
  3688.          working model of this (QuickBASIC-style menus).  Study it closely.
  3689.  
  3690.                                                                            
  3691.          ============== Appendix I:   Creating Big! Fonts ==============
  3692.  
  3693.  
  3694.          You can create as many Big! Fonts as you want.  Each font file
  3695.          may have 1-100 characters.  And "characters" can be anything.
  3696.  
  3697.           * Create a logo where the letter "A" normally goes.  Load this
  3698.             font, then press F7 and "A" to add your logo to your screen.
  3699.             Try this by loading BigLogo.Fnt, then pressing A, B or C.
  3700.  
  3701.           * Add math or other special symbols where letters normally go.
  3702.  
  3703.  
  3704.          The format of a Big! Font file is CRITICAL!  The guidelines you
  3705.          use are simple, but if you don't follow them precisely, you'll
  3706.          get strange results when you type in a Big! Font message.
  3707.  
  3708.           * Lines  1-2             Header information (more on this later)
  3709.  
  3710.           * Lines  3 +             Up to 100 letters, numbers or symbols.
  3711.                                    Each character takes 2 or more lines.
  3712.  
  3713.           * Big! Font files MUST be saved in Ascii format.  Big! Font
  3714.             files must have a ".Fnt" extension so P-Screen recognizes them.
  3715.  
  3716.           * You MUST use quotation marks ("") to surround fields.  If
  3717.             there are 2 or more fields per line (as on Header lines 1 & 2),
  3718.             the fields MUST be separated by commas.
  3719.  
  3720.           * You can stop adding characters at any time.  And you can skip
  3721.             characters; but if you do skip something, you MUST include
  3722.             BLANK lines where the skipped character would normally go.
  3723.  
  3724.  
  3725.          If you're unsure about the format of a font file, use the fonts
  3726.          we sent as examples or templates.  For example, copy one of ours
  3727.          to a new file name, then edit it rather than working from scratch.
  3728.  
  3729.  
  3730.          Here are specific guidelines for creating Big! Font files.
  3731.  
  3732.          Line #1:  Header 1
  3733.  
  3734.           * Line 1 tells P-Screen:  How many characters to expect, how
  3735.             tall each character is (# of lines), and how wide the "Space"
  3736.             character should be.  Line #1 looks something like this:
  3737.  
  3738.             "# of characters","93","# lines per character","7","Space","3"
  3739.  
  3740.             Note line #1 has 3 labels followed by 3 numbers.  Each is
  3741.             surrounded by quotation marks.  And fields are separated by
  3742.             commas (the commas and quotation marks are required!).
  3743.  
  3744.             - # of Characters:      Enter the number of characters in your
  3745.                                     font file (maximum = 100).
  3746.  
  3747.             - Lines per character:  Critical!  P-Screen must know how
  3748.                                     tall each character is so it knows
  3749.                                     when it reaches the end of one and
  3750.                                     the start of another.
  3751.                                                                            
  3752.  
  3753.          Creating Big! Fonts (continued)
  3754.  
  3755.  
  3756.             - Space:                Minimum 1, no Maximum.
  3757.                                     This tells P-Screen how wide the "Space"
  3758.                                     should be between words.  When you press
  3759.                                     the space bar when typing messages,
  3760.                                     P-Screen shifts right this many columns.
  3761.  
  3762.                                     Change this number to vary the spacing
  3763.                                     printed between WORDS.  How you design
  3764.                                     the characters in a font will determine
  3765.                                     the amount of space between LETTERS.
  3766.  
  3767.          Line #2:  Header 2
  3768.  
  3769.           * Line 2 is for future expansion.  It MUST have 3 quoted fields
  3770.             separated by commas.  It could look like "","","".  Or you
  3771.             could enter 3 or more comments inside these quoted fields.
  3772.  
  3773.          Lines 3 - ?
  3774.  
  3775.           * Enter characters beginning on line #3.  The order MUST be:
  3776.             - Lines  3 +             A-Z (capital letters).  Since each
  3777.                                      character takes 2 or more lines, we
  3778.                                      can't show where the next lines begin.
  3779.             - Lines  ?               a-z (lower case letters)
  3780.             - Lines  ?               0-9 (numbers)
  3781.             - Lines  ?               ,.:$&*@#!^-+=%?;()~"'][|\/<>{}
  3782.  
  3783.             You can stop adding characters anywhere.  You can skip
  3784.             characters; but if you do skip something, you MUST include
  3785.             BLANK lines where the skipped character would normally go.
  3786.  
  3787.           * Every character in a font file MUST be the same height, but widths
  3788.             may differ.  Each line MUST be surrounded by quotation marks.
  3789.  
  3790.           * Different characters may can have different widths, which can
  3791.             create something close to proportional spacing.  Or you can
  3792.             set every character to the same width to create fixed spacing.
  3793.             - If you opt for fixed spaced characters, start by working
  3794.               on the 3-4 widest characters:  W, M, @ and #.  Once you
  3795.               find the proper height/width for these, set other char-
  3796.               acters to the same size.
  3797.  
  3798.  
  3799.           * Every line for a character MUST be the same width, though
  3800.             different characters may have different widths.
  3801.             - DON'T add extra space on the right side.  P-Screen adds
  3802.               one blank space to the right of each character.
  3803.             - But DO add space on the left if you need to shift a char-
  3804.               acter, or part of it, right.  For example:
  3805.  
  3806.               " █ █ "  Note: 1) the distance between "   " is the same for
  3807.               "█████"           EVERY line; lines 1 and 5 are shifted right.
  3808.               " █ █ "        2) there's no extra space on the right;
  3809.               "█████"           P-Screen adds a space for you during printing.
  3810.               " █ █ "        3) there's no extra space on the left.
  3811.                                                                            
  3812.  
  3813.  
  3814.          Creating Big! Fonts (continued)
  3815.  
  3816.  
  3817.           * Use any character you want to "draw" fonts -- a normal
  3818.             keyboard character or a "high Ascii" character like #220
  3819.             above.  Later, when you load your font, use F1 Alter to
  3820.             customize it.
  3821.  
  3822.           * Creating characters takes some time.  You could use any word
  3823.             processor.  Or use P-Screen.  In word processors you can
  3824.             work with files of almost any length.  But word processors
  3825.             sometimes make it difficult to "draw" using "high Ascii"
  3826.             characters.  If so, use "x" or any normal keyboard character.
  3827.  
  3828.  
  3829.             Or you could use P-Screen.
  3830.  
  3831.              Advantages:    You can draw using high Ascii characters.
  3832.                             And you can use WalkAbout to trace charac-
  3833.                             ters, and Copy to duplicate characters you
  3834.                             then edit.
  3835.  
  3836.              Disadvantages: Limited work area.  You ultimately need each
  3837.                             character starting on a separate line.
  3838.                             P-Screen gives you 25, 43, or 50 lines to
  3839.                             work with at a time.  This holds only 3-15
  3840.                             characters depending on the height of each.
  3841.  
  3842.                             Options:
  3843.  
  3844.                             - Save different character files.  Then com-
  3845.                               bine them into a single font file using your
  3846.                               word processor or DOS's Copy (eg., copy
  3847.                               font1.pss+font2.pss+font3.pss  Total.Fnt).
  3848.  
  3849.                             - Create several characters on each line.  Then
  3850.                               save the screen to Ascii and use a word pro-
  3851.                               cessor to move characters to separate lines.
  3852.  
  3853.  
  3854.  
  3855.                                                                           
  3856.  
  3857.          ====== Appendix II:  Displaying Screens From QuickBASIC 3 ======
  3858.  
  3859.          To display screens from libraries using QuickBASIC 3.0, just
  3860.          link 2 routines we supply (plus INT86.Obj) to your programs.
  3861.  
  3862.          Name           Format             Description
  3863.          =========      ==============     ===============================
  3864.          QB3LdScr       QuickBASIC 3.0     Open library, find screen in
  3865.                                            Library.  Call an assembler
  3866.                                            routine to load it.  Report
  3867.                                            errors (if any).
  3868.  
  3869.          QB3PScrn       Assembler          Read binary file; display
  3870.                                            screen
  3871.  
  3872.          QB3RstPl       Assembler          Display any size screens
  3873.                                            (registered users receive
  3874.                                            this)
  3875.  
  3876.          To add our routines to a ".Lib" file:
  3877.  
  3878.             Lib MyLib + INT86 + QB3LdScr + QB3PScrn;
  3879.  
  3880.                 (registered users, add "+ QB3RstPl")
  3881.  
  3882.          To add  our routines to a "Quick Library" file:
  3883.  
  3884.             BuildLib  <cr>
  3885.                Object Modules [.OBJ]: INT86 + QB3LdScr + QB3PScrn
  3886.                   (registered users, add "+ QB3RstPl")
  3887.  
  3888.                Run File [USERLIB.EXE]:  MyUser.Exe
  3889.  
  3890.              etc....
  3891.  
  3892.  
  3893.          Example     (Run QB3-Demo.Bas for more examples. See next page!)
  3894.          .......
  3895.  
  3896.          ArraySize = 2000: Redim Array% (ArraySize)
  3897.  
  3898.          LibName$ = "MyLib": ScreenName = "MyScreen"
  3899.  
  3900.          CALL QB3LoadScrn (Array%(), LibName$, ScreenName$ Desc$,    _
  3901.               TopRow, LeftCol, BotRow, RhtCol, (ArraySize), ErrCode)
  3902.  
  3903.          '...NOTE parentheses around ArraySize ^^^^^^^^^^^
  3904.  
  3905.  
  3906.          IF ErrCode >=0 THEN
  3907.  
  3908.             CALL PTR86 (Segment%, OffSet%, VARPTR(Array%(1)))
  3909.  
  3910.             CALL QB3CompRest (TopRow, BotRow, Segment%, OffSet%)
  3911.  
  3912.             '...registered users would use : : :
  3913.             CALL QB3CompRestPLUS (TopRow, LeftCol, BotRow, RhtCol, _
  3914.                                   Segment%, OffSet%)
  3915.          END IF                                                          
  3916.  
  3917.          QuickBASIC 3.0 (continued)
  3918.  
  3919.          Details
  3920.          .......
  3921.  
  3922.          1.  Call QB3LoadScrn from your QB 3.0 programs.
  3923.              - It finds the screen you requested (or reports errors).
  3924.              - It calls several assembler routines to load a binary
  3925.                screen into an array.
  3926.  
  3927.          2.  Call Ptr86 (included in Microsoft's Int86.Obj) to locate array.
  3928.  
  3929.          3.  Call QB3CompRest (or QB3CompRestPLUS) to display screens.
  3930.  
  3931.          You provide: ArraySize     CRITICAL!  Your array MUST be
  3932.                                     dimensioned large enough to hold
  3933.                                     each screen.  When we find your
  3934.                                     screen, we check its size against
  3935.                                     ArraySize.  If your array isn't
  3936.                                     large enough, we exit with ErrCode =
  3937.                                     -88. Why?  If we tried to load, say,
  3938.                                     a 3000 byte screen into a 1000
  3939.                                     element array, your program would
  3940.                                     crash!
  3941.  
  3942.                                     - ArraySize is in parentheses so
  3943.                                       QB3LoadScrn doesn't change it.
  3944.                                       If you don't do this, QB3LoadScrn
  3945.                                       changes it, setting it to the size
  3946.                                       of your screen.
  3947.  
  3948.                        Array%()     1-dimension INTEGER array.
  3949.  
  3950.                        LibName$     1-8 character library file name.
  3951.  
  3952.                                     - DON'T include extension.  We add
  3953.                                     ".PSL"
  3954.  
  3955.                                     - Include a full path if your library
  3956.                                       is elsewhere. (eg., "B:\MyLib")
  3957.  
  3958.                     ScreenName$     1-8 character screen name (no extension)
  3959.  
  3960.  
  3961.            We return:  Array%()     Loaded with screen (if no error occurred)
  3962.                                      - We load screens beginning at element 1.
  3963.                                      - So restore from Array% (1) NOT 0!
  3964.  
  3965.                           Desc$     Screen Description saved in the library
  3966.                 TopRow, LeftCol \   Screen coordinates to restore screen
  3967.                  BotRow, RhtCol /
  3968.  
  3969.                       ArraySize     Size of compressed screen (unless you sent
  3970.                                     ArraySize down wrapped in parentheses)
  3971.  
  3972.                         ErrCode     >=0  = # of bytes loaded or 0 (no error).
  3973.                                     -88  = Your array was too small.
  3974.                                     -99  = Screen NOT found in library.
  3975.                                     - 1  = Library NOT found; or 0 size screen 
  3976.  
  3977.  
  3978.          QuickBASIC 3.0 (continued)
  3979.  
  3980.  
  3981.                         Important Notes for QB 3.0 Users:
  3982.                                             ^^^^^^
  3983.  
  3984.  
  3985.          When you CALL QB3LoadScrn, it opens your screen library file
  3986.          to find the screen you want.
  3987.  
  3988.            * It OPENs this file as file number 99.  If your program
  3989.              already has a file opened as #99, an error will occur.  The
  3990.              only way around this is to change your program and open the
  3991.              OTHER file as, say, #98 instead of #99.
  3992.  
  3993.            * We hope this doesn't inconvenience you.
  3994.  
  3995.  
  3996.          You MUST link Int86.Obj to your programs.  QB3LoadScrn CALLs
  3997.          Ptr86.  You must also use it to locate your array before dis-
  3998.          playing it.  Ptr86 is part of Int86.Obj, supplied by Microsoft
  3999.          on your QB 3.0 disk.  The ".asm" source code is also on that disk.
  4000.  
  4001.            * Int86.obj contains several routines P-Screen does NOT need.
  4002.              This may add unnecessary overhead to your program.
  4003.  
  4004.            * If your program also CALLs Int86 (or a variation), there's
  4005.              no problem -- you're already using the extra routines.
  4006.  
  4007.            * But, if you don't CALL Int86, you'll have to endure the
  4008.              extra overhead, unless you have an assembler (eg., MASM)
  4009.              and can delete the Int86 routines and re-assemble Int86.asm.
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.                                                                            
  4016.          ================= Appendix III:   Error Messages =================
  4017.  
  4018.          We try to prevent most errors from disrupting your work.
  4019.          P-Screen checks to ensure your printer's ready (LPT1 only)
  4020.          before you start printing.  And it checks to see if files exist,
  4021.          alerting you if you try to load a non-existent screen or file.
  4022.  
  4023.          Most other errors will probably be due to disk or printer
  4024.          errors: your printer runs out of paper, the disk drive door
  4025.          is open, or you run out of disk space while saving a screen.
  4026.           * With most errors, P-Screen sounds an alarm and asks you
  4027.             to fix the problem then press a key.
  4028.  
  4029.           * With other errors, P-Screen reports an error number, and tells
  4030.             you it can't go on.  Press a key and P-Screen will try to
  4031.             start over.  But you'll loose the screen you were working on.
  4032.             - This is one reason we urge you to save screens often.
  4033.               If you loose one due to an error, just re-load it.
  4034.             - If errors recur please let us know.  Tell us the error number,
  4035.               and describe exactly what you were doing when it happened.
  4036.  
  4037.           * If major errors occur twice (an error reported on the bottom
  4038.             of your screen with a message like "Error (##). ....."), we
  4039.             urge you to EXIT P-Screen and restart it.  (If possible,
  4040.             save your work first, but it may already be gone.)
  4041.             - The reason you should exit:  All errors occur inside a
  4042.               subroutine (sometimes 2-4 layers deep).  When a major
  4043.               error occurs and P-Screen re-starts, these routines are
  4044.               still unresolved (ie., still on the stack).
  4045.             - If this happens twice, you'll run out of stack space. P-Screen
  4046.               will stop -- maybe after displaying an irrelevant message.
  4047.             - Microsoft assures us there's no way around this (thanks MS).
  4048.  
  4049.           * Your help screens come in a screen library called P-Screen.Psl.
  4050.             Feel free to load and look at any P-Screen screen.  But please
  4051.             don't Save screens to it.  An error may occur if you try.
  4052.             - We protected this file to help you -- to ensure that as you
  4053.               share the shareware version of P-Screen with others, the
  4054.               help, demo and main screens aren't corrupted.
  4055.  
  4056.          Here's a summary of most errors you might get.  An asterisk after
  4057.          an error number means it's probably fatal.
  4058.          Printer
  4059.            24   Timeout (printer may be off or off-line)
  4060.            27   Out of paper
  4061.            25   Device fault (may be disk/modem/other device error)
  4062.            57   Device Input/Output error (disk/modem/other device error)
  4063.            68   Device unavailable (not on-line or doesn't exist)
  4064.          Disk   (also see above:  25, 57, 68)
  4065.            61*  Disk full  (fatal unless you can change disks)
  4066.            67*  Too many files on disk/directory (fatal unless you change disks)
  4067.            70   Permission denied (disk is write-protected or file is locked)
  4068.            71   Disk not ready
  4069.            72   Media error (damaged/unformatted/ disk)
  4070.          Other
  4071.            Math         6*   Overflow.  A number is too large.
  4072.            Memory   7, 14*   Out of memory (eliminate TSRs/Device drivers/etc.)
  4073.            Files       7x    Path or File not found or other Path/File error   
  4074.  
  4075.  
  4076.          ii             Three Questions About Registering....
  4077.  
  4078.                                WHAT IS SHAREWARE?
  4079.  
  4080.          I GOT A COPY FOR NOTHING.  WHY SHOULD I PAY A REGISTRATION FEE?
  4081.  
  4082.          I GOT P-Screen FROM A COMPANY THAT "SELLS" SHAREWARE PROGRAMS.
  4083.            I PAID THEM FOR P-Screen.  WHY SHOULD I REGISTER WITH YOU?
  4084.  
  4085.          These are good questions.  Here's a response.  (Our response
  4086.          applies to user-supported software in general, not just P-Screen.)
  4087.  
  4088.          Shareware is NOT free software.  A better term is "user-
  4089.          supported" software.  Why?  Because authors of "user-supported"
  4090.          software spend long, hard hours developing programs, debugging
  4091.          them, and writing manuals.  They DEPEND on your support (and
  4092.          comments and an occasional "thank you") to keep going -- to
  4093.          justify the time and sweat.
  4094.  
  4095.          You get to "try it before you buy it," to see if it works and
  4096.          meets your needs.  You get to enjoy the result, at very
  4097.          reasonable prices.  And registering your copy (supporting
  4098.          the author) brings you other benefits as well.  These include
  4099.          (depending on the program):  the latest version often with new,
  4100.          more or better features, extra "goodies," a printed manual,
  4101.          phone support, updates, etc.
  4102.  
  4103.          Shareware "works" because people like you:  (1) are honest;
  4104.          and, (2) understand authors will stop "sharing" their work if
  4105.          they receive no support.  In short, if you fail to even
  4106.          acknowledge the contributions authors make, or support their
  4107.          efforts (even modestly), the well will dry up.  The only one
  4108.          to lose will be you (and the "shareware distributors").  Since
  4109.          you made no contribution anyway, the developer loses nothing.
  4110.  
  4111.          In response to the third question, many firms now "sell" user-
  4112.          supported software (or shareware).  They charge you a fee for
  4113.          their time and the expense of sending you a disk.  NONE of the
  4114.          fee you give them goes to the author of the software!  So when
  4115.          you pay $1-$5.00 for a disk full of shareware, you're NOT
  4116.          supporting the person who spent their time developing ideas
  4117.          you're now enjoying.
  4118.  
  4119.  
  4120.                                                                          
  4121.  
  4122.          iii              Other Programs by Pro~Formance
  4123.  
  4124.                             (Call or write for details)
  4125.  
  4126.          ================================================================
  4127.          Professional Scribe (Pro~Scribe)                PS Express (PSE)
  4128.          ================================================================
  4129.  
  4130.          Pro~Scribe and PSE help you improve anything you write (or help
  4131.          you improve the writing of others -- your staff, students, etc.)
  4132.  
  4133.          Pro~Scribe/PSE are used in many companies (like IBM, Hewlett
  4134.          Packard, Lockheed, Citibank, Mobil Oil, Bank of America) to help
  4135.          improve memos, letters, manuals, documentation, contracts,
  4136.          promotional material, etc.
  4137.           * They examine your writing for many types of writing mistakes.
  4138.           * You can look at overall results for an entire letter, report,
  4139.             etc.  Or, if you like, they'll look at your writing line-by-line.
  4140.           * They show suspect problems, and offer suggestions.
  4141.           * Results are shown numerically, and with several colorful graphs.
  4142.           * They come with two manuals (in addition to a Quick Ref. Guide)
  4143.             - One covers basics: To install/run PS, and basic guidelines.
  4144.             - "Effective, High-Impact Writing" has more writing tips.
  4145.           * They're colorful, fast, fun, and a terrific value:  $39 for both!
  4146.  
  4147.          How are Pro~Scribe and PSE different?   First, PS Express is a
  4148.          RAM-resident program.  That means it's always ready to help
  4149.          when you need help most--while you're actually writing.  Run
  4150.          PSE, then run your word processor and start writing.  Need
  4151.          help? Just press a key.
  4152.           * When PSE pops up, just mark the text you want PSE to look at.
  4153.             A window pops up instantly with feedback on your writing.
  4154.           * PSE is like having an English teacher looking over your
  4155.             shoulder, gently coaching you as you write.
  4156.  
  4157.          Pro~Scribe gives you everything PSE does, and much, much more.
  4158.          It reads files saved by your word processor, or you can type
  4159.          text directly into PS.  Like PSE, Pro~Scribe shows how complex
  4160.          your writing, words and sentences are.  It also offers you:
  4161.           * Feedback on "Word Wasters"  (5 categories of writing errors).
  4162.           * Three RGL (Running Grade Level) options, giving you line-by-
  4163.             line feedback.
  4164.           * An option to flag complex words and Word Wasters in each line.
  4165.           * A Personal Interest score--showing if you write as you speak.
  4166.           * Options to:  customize the program, print results on your
  4167.             printer, get help interpreting results.
  4168.  
  4169.                                                                          
  4170.          Other Programs by Pro~Formance  (continued)
  4171.  
  4172.          ================================================================
  4173.          Mail Call  (also see inform-Z below)            MC Express (MCE)
  4174.          ================================================================
  4175.  
  4176.          Mail Call (MC) is a full featured mailing assistant.  Add names
  4177.          to a database, then Browse through them, Search, Print, etc.
  4178.           * Print envelopes (several sizes)
  4179.           * Print mailing labels (several sizes plus a "roll-your-own-size"
  4180.             option).  1 to 99 copies of each label, 1 to 3 columns across
  4181.           * Print "personalized documents" (like "mail merge form letters")
  4182.           * Print forms, with edit fields, math, dates, sequence numbers, etc.
  4183.           * Print reports, phone books, appointment schedules, etc.
  4184.  
  4185.          Mail Call offers UNlimited capacity -- use as many database files
  4186.          as you want.  And its "Mail Merge" option lets you Import or Export
  4187.          names to files used by word processors or other database programs.
  4188.  
  4189.          MC Express is a "RAM-resident" program that lets you: 1) print
  4190.          envelopes while INSIDE your word processor; and, 2) lets you
  4191.          "write out" names and addresses to a file you can later "import"
  4192.          into MC (no re-typing). (Optional; works with HP LaserJets)
  4193.  
  4194.          ================================================================
  4195.          inform-Z (also see Mail Call)          Professional Forms Design
  4196.          ================================================================
  4197.  
  4198.          inform-Z is a complete form system.  Design, math, printing,
  4199.          database capabilities and "auto-edit" features are all built in.
  4200.          You can easily design, edit and print forms.  Samples are included.
  4201.           * Draw lines or boxes, or add shading, in several styles
  4202.           * Enter text, auto-centered inside boxes if you like
  4203.           * Automatically date your forms.  Add automatic "sequence numbers."
  4204.           * Math options (+-/*) add spreadsheet convenience, speed & accuracy
  4205.           * Quick, easy block options:  Copy, Move, Erase, Shading
  4206.           * Vary fonts, type styles, line spacing
  4207.  
  4208.          And you can use inform-Z or Mail Call to fill out forms.
  4209.           * Add "auto-edit" fields to let you quickly skip through a
  4210.             form, editing just fields you "marked."  Then use the math
  4211.             features to do the calculations for you -- automatically!
  4212.           * Use Mail Call to fill in other information for you --
  4213.             pulling names, addresses, etc. from your database, putting
  4214.             them right where you want them.
  4215.  
  4216.          Produce high-quality, professional looking forms in minutes with
  4217.          Epson printers or HP LaserJets (+/500/Series II or later).  And
  4218.          you DON'T need expensive font cartridges or soft fonts for lines,
  4219.          boxes, shading, etc.  We use built-in features for these.  "But,
  4220.          I don't have a LaserJet or an Epson" you say.  Not to worry.
  4221.          inform-Z has two other printer options so it works with any printer.
  4222.  
  4223.          Finally, with both inform-Z and Mail Call you can manage almost
  4224.          every piece of paper in your office.
  4225.            Forms:       Invoices, Purchase Orders, Personnel Forms, Work
  4226.                         Orders, Work Schedules, Travel or Expense Reports,
  4227.                         Accounting Forms, Application Blanks, Org. Charts
  4228.            As Well As:  Letters, Memos, Envelopes, Mailing Labels, Person-
  4229.                         alized Documents, Reports, Client or Employee lists.  
  4230.  
  4231.  
  4232.          Other Programs by Pro~Formance  (continued)
  4233.  
  4234.          ================================================================
  4235.          P~F Presents       *** See the first few pages for details. ***
  4236.          ================================================================
  4237.  
  4238.          P~F Presents, a P-Screen companion, is our desktop presentation
  4239.          system.  It displays screens from P-Screen screen libraries.  It
  4240.          also lets you create presentations with:  Menus (3 styles),
  4241.          display and sound effects, "subroutines" (gosubs), "loops", etc.
  4242.  
  4243.          ================================================================
  4244.          The Survey Catalyst  (TSC; a commercial program, not shareware)
  4245.          ================================================================
  4246.  
  4247.          The Survey Catalyst is for anyone who works with attitude or opinion
  4248.          surveys.  It helps you create surveys in minutes or hours--not days!
  4249.           * TSC includes a database of thousands of survey items--like
  4250.             items used in most Fortune 1000 companies' employee surveys.
  4251.             - You can review items, edit them or add new ones.
  4252.             - OR, when you see an item you want to add to a survey, just
  4253.               press a key and add it--fast and simple.
  4254.           * And TSC's many printing options let you create "camera-ready" copy
  4255.             - Group items by Category, by Response Scale, or Randomize them.
  4256.             - Print response scales Above or Beside items (or not at all).
  4257.             - Print key punch instructions (or not at all)
  4258.             - Print a title--at the top or bottom of each page.
  4259.             - Or, print your survey "to a file"--to dress it up later.
  4260.  
  4261.          ================================================================
  4262.          Pro~Stamp        Stamp Collection Manager
  4263.          ================================================================
  4264.  
  4265.          Pro~Stamp is a full-featured assistant to manage stamp collections.
  4266.  
  4267.           * Pro~Stamp is very easy to use:  Pull-down menus, Extensive
  4268.             Help Screens, Calculations done for you, Select "Type" &
  4269.             "Condition" from menus.
  4270.           * Add information to "worksheets."  They're set up like most
  4271.             popular collectors' manuals (eg., Scott).  But we add
  4272.             "spreadsheet" convenience by doing calculations for you!
  4273.           * Track small to huge stamp collections, with ease and convenience
  4274.           * Multiple file options add flexibility.  Use different work-
  4275.             sheets for different subsets of your collection.
  4276.           * Spreadsheet convenience:  Automatically calculates values of
  4277.             each stamp and its Increase/Decrease in value.  Calculate the
  4278.             value of your entire collection with a press of a key.
  4279.           * Sort your collection on any of several fields (Scott Number,
  4280.             Country, Value, Type, etc).
  4281.           * Print entire worksheets, or print a range you specify.
  4282.           * Customizable:  Configure fields your way, edit printer codes.
  4283.  
  4284.                                                                              
  4285.          ================================================================
  4286.                                     Ram-Man
  4287.          ================================================================
  4288.          Ram-Man is a RAM-resident (TSR) program to turn ANY text file
  4289.          into a pop-up quick-reference guide (or manual).
  4290.  
  4291.           * Pop up your text file while you're working in virtually any
  4292.             text-based (not graphics) program.
  4293.           * BROWSE through it.
  4294.           * SEARCH, looking for a topic or phrase you're interested in.
  4295.           * LOOK UP words, which we'll read directly from your screen!
  4296.  
  4297.          We supply the RAM-resident "engine," you supply the text.  Ram-
  4298.          Man preserves DOS memory by keeping ONLY its engine in memory.
  4299.          It displays your text from disk (hard or RAM disk recommended).
  4300.  
  4301.          You can change which file you're viewing without unloading
  4302.          Ram-Man.  That means you load Ram-Man once, then change ref-
  4303.          erence guides as your needs or the programs you use change.
  4304.                                            
  4305.          Now, regardless of which text-based program you're using (or
  4306.          even at the DOS prompt), you can have on-line, pop-up help
  4307.          available -- at any time, at the press of a key.
  4308.  
  4309.  
  4310.          Examples:       
  4311.           * The complete, on-disk manual for a program you're using.
  4312.           * A series of help screens or "Quick Reference Guides"
  4313.             (eg., tips on using DOS, tips on using a program).
  4314.             - You can display standard DOS text files, like those
  4315.               you create using an editor or word processor.
  4316.             - Or you can display special "screens" you create with
  4317.               programs like our P-Screen Screen Designer.
  4318.           * Appointment Calenders, To Do Lists. . . . etc.
  4319.  
  4320.  
  4321.          Other features:   (<R> = REGISTERED versions.)
  4322.  
  4323.           * BROWSE through files -- line by line or page by page.  And
  4324.             you can jump to the top or bottom of small -or- huge text
  4325.             files in 1/2 second or less.
  4326.  
  4327.           * SEARCH for topics relevant to your needs.
  4328.  
  4329.           * <R> "LOOK UP" reads a word directly off your screen THEN
  4330.             searches for it!  BE SURE to read the section on Look Up for
  4331.             uses (eg., Quick reference, spelling, thesaurus, quotations).
  4332.  
  4333.           * UNLOAD Ram-Man and reclaim the memory it uses.
  4334.  
  4335.           * <R>  RUN-TIME OPTIONS let you choose:
  4336.             - The "hotkey" you want to use to call Ram-Man up.
  4337.             - The size of the screen you want to use -- to let you
  4338.               switch between 25, 43 or 50 row screens at will.
  4339.             - The colors we use to display text.
  4340.  
  4341.               These options help ensure that Ram-Man's hotkey, colors
  4342.               and screen modes never conflict with the programs you use.  
  4343.                                                                              
  4344.                                                                              
  4345.   +--------------------------------------------------------------------------+
  4346.  
  4347.    This order form has TWO PAGES : : :
  4348.  
  4349.       * This page (when folded) becomes your "envelope."
  4350.         The next page is the actual order form.
  4351.  
  4352.       * You can : : :
  4353.         - Print 1 page then turn the paper over & print page #2 on the back.
  4354.         - Print them on separate pages.  If you use continuous-feed paper,
  4355.           you can print both pages at once, then just fold them together.
  4356.  
  4357.       * BE SURE to enclose the other page INSIDE this one.
  4358.  
  4359.         Be sure your check or money order, if appropriate, is
  4360.         enclosed and securely attached (stapled or taped).
  4361.  
  4362.  
  4363.  
  4364.    ----------------------------  Fold here 1st  ----------------------------
  4365.  
  4366.     From:                                                          -------
  4367.                                                                     Stamp
  4368.     __________________________                                      Here
  4369.                                                                    -------
  4370.     __________________________
  4371.  
  4372.     __________________________
  4373.  
  4374.     __________________________
  4375.  
  4376.  
  4377.                                                    Rob W. Smetana
  4378.                                                    Pro~Formance
  4379.                                                    132 Alpine Terrace
  4380.     Programs ordered:  ____________________        San Francisco, CA  94117
  4381.  
  4382.     _______________________________________
  4383.  
  4384.     _______________________________________
  4385.  
  4386.    ----------------------------  Fold here 2nd  ----------------------------
  4387.  
  4388.     WARRANTY : : :
  4389. t                                                                             t
  4390. a     We warrant the disks we sent you, if any, to be free from physical      a
  4391. p     defects for a period of 30 days from the date we ship them.             p
  4392. e                                                                             e
  4393.       Since you can try "user supported" versions of our programs before
  4394. or    ordering them, we offer no other warranty beyond that stated here.      or
  4395.       We'll gladly replace defective disks.  But no refunds or credits        s
  4396. s     can be issued.                                                          t
  4397. t                                                                             a
  4398. a     Where did you get your copy of our program? ______________________      p
  4399. p     My Computer's a:_________________  My Printer's a:________________      l
  4400. l     My Monitor is: (circle 1)  Mono / CGA / EGA / VGA / Herc / Other        e
  4401. e
  4402.         (Please use the other side for comments & suggestions.  Thanks!)
  4403.                            <<< Tape or Staple Here >>>
  4404.                                                                                
  4405.   ============================================================================
  4406.                  T O   O R D E R   : : :           (Also send page above this)
  4407.   ============================================================================
  4408.  
  4409.    F ______________________________________________ M   Rob W. Smetana
  4410.                                                         Pro~Formance
  4411.    R ______________________________________________ A T 132 Alpine Terrace
  4412.                                                         San Francisco, CA 94117
  4413.    O ______________________________________________ I O (415) 863-0530
  4414.  
  4415.    M ______________________________________________ L   Make checks payable to::
  4416.                                                            Rob W. Smetana
  4417.    Phone (      ) ______-________  Date ___/___/___
  4418.    (If ordering by credit card, be sure name is as it appears on your card.)
  4419.  
  4420.   ================================================================ pscrn 4.2 =
  4421.   Program                                 # of Copies  Price/Copy     Total
  4422.   ============================================================================
  4423.   P~F Presents / P~F Presents Professional _________    $49 / $79   $ ________
  4424.   The Presentation Suite                   _________       $49      $ ________
  4425.   inform-Z  Professional Forms Design      _________       $49      $ ________
  4426.   Mail Call (Without / With MC Express)    _________    $40 / $49   $ ________
  4427.   Pro~Scribe & PS Express                  _________       $39      $ ________
  4428.   P-Screen (Plus / PS Professional)        _________    $29 / $49   $ ________
  4429.   Multi-Print                              _________       $39      $ ________
  4430.   Pro~Stamp Stamp Collection Manager       _________       $29      $ ________
  4431.   Ram-Man RAM-resident Manuals/Reference   _________       $19      $ ________
  4432.   Sparkle  AND  Menu Magic                 _________       $19      $ ________
  4433.   The Survey Catalyst (TSC)/Demo Disk      _________   $595 / $5    $ ________
  4434.   ============================================================================
  4435.      PACKAGE DISCOUNTS                    (Call about quantity discounts)
  4436.   ============================================================================
  4437.   Mail Call  AND  inform-Z                 _________       $79      $ ________
  4438.  
  4439.   P-Screen Pro  AND  P~F Presents          _________      $109      $ ________
  4440.   (Professional versions of both!)
  4441.   (NOTE:  P~F Presents DOES include a copy of P-Screen +)
  4442.  
  4443.   The Works! 1 of each (exc. The Catalyst) _________      $229      $ ________
  4444.   ============================================================================
  4445.        Shipping & Handling                         $4/copy US & Canada
  4446.      Total Number of Programs ----->>      _______ $8/copy Elsewhere $ _______
  4447.   ==========================+=================================================
  4448.   PAID BY: (Check one !!!)  |                             Subtotal  $ ________
  4449.                             |
  4450.   ___ Check                 |   California residents, add 6.5% tax  $ ________
  4451.                             +-----------------------------+-------------------
  4452.   ___ Master   ___ VISA                                   |
  4453.       Card                                                |  TOTAL  $ ________
  4454.  =========================================================+====================
  4455.   *** Orders from Outside the US: International Money Orders, US Funds ONLY.***
  4456.  
  4457.   THE FOLLOWING IS REQUIRED for credit card orders (can't process order w/o it).
  4458.  
  4459.    Credit Card Number:  ______________________________    Expires: ___/___/___
  4460.  
  4461.    Signature (Required for credit card orders): ______________________________
  4462.  
  4463.   (Be sure name at top is as it appears on your card AND you check Visa or MC.)
  4464.   ==================[ Please see Warranty on the page above ]================= 
  4465.